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H $k 


PHP Array žk 


PHP array() 
PHP array change key case() 函数 
PHP array. chunk() 函数 
PHP array combine() EZ 
PHP array. count values() 2 
PHP array. diff() 函数 
PHP array diff assoc() 函数 
PHP array diff key() HX 
PHP array diff uassoc() E32 
PHP array diff ukey() Až 
PHP array fill() Eq2& 
PHP array filter() Ez 
PHP array. flip() aX 
PHP array. intersect() EX 
PHP array intersect assoc() HŽ 
PHP array. intersect key() BAžš 
PHP array intersect uassoc() 函数 
PHP array intersect ukey() aX 
PHP array key exists() 函数 
数 

数 
PHP array merge() HŽ% 


PHP array keys() EB 
PHP array map() Eg 
PHP array merge recursive() HŽ 
PHP array multisort() HX 

PHP array. pad() HX 

PHP array pop() 2 

PHP array product() 2 

PHP array. push() KIŠ% 
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PHP array rand() ax 

) BK 
PHP array reverse() BAžš 
PHP array search() EZ 
PHP array shift() Eg 
PHP array slice() aX 

PHP array splice() AX 

PHP array sum() HŽ% 

PHP array udiff() HX 

PHP array udiff assoc() 函数 


PHP array udiff uassoc() 函数 


PHP array reduce() FK 


PHP array uintersect() EX 

PHP array uintersect assoc() HŽ 
PHP array uintersect uassoc() 函数 
数 

PHP array values() EZ 

PHP array walk() aX 


PHP array unique() EZ 
PHP array unshift() B 


PHP array walk recursive() Ex 
PHP arsort() HK 

PHP asort() 函数 

PHP compact() aX 
PHP count() 函数 

PHP current() 2 
PHP each() 函数 

PHP extract() EX 
PHP in array() 函数 
PHP key() 2X 

PHP krsort() EX 

PHP ksort() EX 

PHP list() 函数 

PHP natcasesort() aX 
PHP natsort() aX 
PHP next() EZ 
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PHP pos() ZX 
PHP prev() HŽ% 
PHP range() 函数 
PHP reset() 函数 
PHP rsort() EK 
PHP shuffle() E& 
PHP sizeof() 函数 
PHP sort() aX 
PHP uasort() E 
PHP uksort() B 
PHP usort() 3X 
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PHP Calendar 函数 
PHP cal days in month() EA 


PHP cal from jd() 函数 
PHP cal info() HX 
PHP cal to jd() HŽ 
PHP easter date() 函数 
PHP easter days() HŽ% 
PHP FrenchToJD() ax 
PHP GregorianToJD() EH 
PHP JDDayOfWeek() 函数 
PHP JDMonthName() 2X 
PHP JDToFrench() 函数 
PHP JDToGregorian() 函数 
PHP JDToJewish() 函数 
PHP JDToJulian() 函数 
PHP JDToUnix() HŽ 

PHP JewishToJD() 函数 
PHP Julian ToJD() 2X 
PHP UnixToJD() HX 


[i 


PHP cURL Fah 


PHP curl_close 郴 数 
PHP curl copy handlebižk 
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PHP curl errnofkiž 

PHP curl errorEg 2i 

PHP curl escapelšižk 

PHP curl execER 2X 

PHP curl file createExZk 

PHP curl getinfoEq 2 

PHP curl init 2 

PHP curl multi add handleEq2K& 
PHP curl_multi_closeH 2X 
PHP curl_multi_execE 2% 
PHP curl_multi_getcontent# 2X 
PHP curl multi info readdžk 
PHP curl multi initEg2X 

PHP curl multi remove handlePg 2X 
PHP curl_multi_selectE 2% 
PHP curl_multi_setoptE 2% 
PHP curl multi strerrorikižk 
PHP curl pauseližk 

PHP curl reset 

PHP curl_setopt_arrayE 2X 
PHP curl_setoptEy#% 

PHP curl share close 
PHP curl share initEq2& 

PHP curl share setoptižižk 
PHP curl_strerrorE 2X 

PHP curl unescaperxZi 

PHP curl versionEg 2X 


PHP Date / Time 函数 


PHP checkdate() ER2& 

SE» 
PHP date default timezone set() 函数 
PHP date sunrise() 函数 
PHP date sunset() 函数 


PHP date() 函数 


PHP date default timezone get() 
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PHP getdate() Bi 

PHP gettimeofday() EZ 
PHP gmdate() 函数 

PHP gmmktime() HŽ 
PHP gmstrftime() 函数 
PHP idate() Et 

PHP localtime() 函数 
PHP microtime() E#X 
PHP mktime() 函数 
PHP strftime() BIZ 
PHP strptime() 函数 
PHP strtotime() HŽ% 
PHP time() KŻ 


PHP Directory HX 


PHP chdir() HË 
PHP chroot() Eg 
PHP dir() 3X 
PHP closedir() 函数 
PHP getcwd() EZ 
PHP opendir() 函数 
PHP readdir() HË 
PHP rewinddir() 函数 
PHP scandir() 3X 


PHP Error 和 Logging 函数 


PHP debug backtrace() 函数 

PHP debug print backtrace() 函数 
PHP error get last() 函数 

PHP error log() 函数 

PHP error reporting() HX 

PHP restore error handler() HË 
PHP restore exception handler() 函数 
PHP set error handler() 2X 

PHP set exception handler() 函数 
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PHP trigger error() HŽ 


PHP Filesystem Eq2& 


PHP basename() ER2 

PHP chgrp() HŽ 

PHP chmod() HŽ 

PHP chown() Eg 

PHP clearstatcache() aX 
PHP copy() aX 

PHP dirname() 函数 

PHP disk free space() HŽ 
PHP disk total space() HŽ 
PHP diskfreespace() HŽ 
PHP fclose() aX 

PHP feof() Ex 

PHP fflush() 函数 

PHP fgetc() 函数 
PHP fgetcsv() EX 
PHP fgets() 函数 
PHP fgetss() HŽ 
PHP file() 函数 

PHP file exists() HŽ 


— = 


PHP file get contents() HX 
PHP file put contents() 2 
PHP fileatime() 函数 

PHP filectime() Až 
PHP filegroup() HŽ% 
PHP fileinode() 函数 
PHP filemtime() 2X 
PHP fileowner() Až 
函数 
Eg 


) 
() 
() 
PHP fileperms() 
PHP filesize() BAž 
PHP filetype() EI#X 
PHP flock() IŽ 
PHP fnmatch() Eq2& 


<2. | 


W3School PHP 参考 手册 


PHP fopen() aX 

PHP fpassthru() aX 
PHP fputcsv() EZ 

PHP fputs() 函数 

PHP fread() 函数 

PHP fscanf() HŽ 

PHP fseek() Až 

PHP fstat() Eq 

PHP ftell() HË 

PHP ftruncate() aX 
PHP fwrite() KIZ 

PHP glob() Ea 

PHP is dir() 函数 

PHP is executable() aX 
PHP is file() HX 

PHP is link() RIŽ 

PHP is readable() 函数 
PHP is uploaded file() FAižk 
PHP is writable() EZ 
PHP is writeable() 函数 
PHP link() 函数 

PHP linkinfo() IŽ% 

PHP Istat() 函数 

PHP mkdir() ES 

PHP move uploaded file() HŽ% 
PHP parse ini file() EX 
PHP pathinfo() 函数 

PHP pclose() 函数 

PHP popen() Až 

PHP readfile() 函数 


x Bg EE 


EZ 
PHP realpath() 函数 
PHP rename() HŽ 
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PHP rewind() Ea 

PHP rmdir() HŽ 

PHP set file buffer() EgZ 
PHP stat() HŽ 

PHP symlink() 2 

PHP tempnam() 函数 
PHP tmpfile() 函数 

PHP touch() HŽ 

PHP umask() Eq2& 

PHP unlink() Eq2& 


PHP Filter EN 2X 


PHP filter has var() aX 
PHP filter id() HX 
PHP filter input() 函数 


PHP filter input array() HX 


PHP filter list() BX 
PHP filter var array() 函数 
PHP filter var() HŽ% 


PHP FTP Eat 


PHP ftp alloc() 函数 
PHP ftp cdup() EX 
PHP ftp chdir() EX 
PHP ftp chmod() 2X 
PHP ftp close() 2X 
PHP ftp connect() 函数 
PHP ftp delete() 函数 
PHP ftp exec() 函数 

PHP ftp fget() 函数 

PHP ftp fput() HX 

PHP ftp get option() ES 
PHP ftp get() Exi 

PHP ftp login() HX 

PHP ftp mdtm() 2X 
PHP ftp mkdir() 函数 
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PHP ftp nb continue() HŽ% 
PHP ftp nb fget() Ex 
PHP ftp nb put() HŽ 
PHP ftp nlist() Eis 
PHP ftp pasv() 函数 
PHP ftp put() ES 
PHP ftp pwd() 函数 
PHP ftp quit() RIŽ 
PHP ftp raw() EX 

PHP ftp rawlist() 2 

PHP ftp rename() 函数 

PHP ftp rmdir() KRIŽ% 

PHP ftp set option() 函数 

PHP ftp site() 函数 

PHP ftp size() HŽ 

PHP ftp ssl connect() HŽ% 

PHP ftp systype() 函数 
PHP HTTP Fax 

PHP header() Eg 

PHP headers list() Ex2& 

PHP headers sent() 函数 

PHP setcookie() aX 

PHP setrawcookie() HŽ 
PHP libxml Bax 

PHP libxml clear errors() aX 

PHP libxml get errors() Eg 

PHP libxml get last error() HŽ 

PHP libxml use internal errors() E32 
PHP Mail Až 

PHP mail() 2X 
PHP Math fax 

PHP abs() 函数 

PHP acos() 函数 
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PHP acosh() 函数 13.3 
PHP asin() 函数 13.4 
PHP asinh() 函数 13.5 
PHP atan() 和 atan2() 2X 13.6 
PHP atanh() 函数 13.7 
PHP base convert() 函数 13.8 
PHP bindec() 函数 13.9 
PHP ceil() HŽ 13.10 
PHP cos() FIŻ 13.11 
PHP cosh() 2X 13.12 
PHP decbin() AX 13.13 
PHP dechex() ER2X 13.14 
PHP decoct() 函数 13.15 
PHP deg2rad() 函数 13.16 
PHP exp() 画 数 13.17 
PHP expm1() ER2& 13.18 
PHP floor() 函数 13.19 
PHP fmod() 函数 13.20 
PHP hexdec() 函数 13.21 
PHP hypot() Ea 13.22 
PHP is finite() BAK 13.23 
PHP is infinite() 函数 13.24 
PHP is nan() 函数 13.25 
PHP leg value() Až 13.26 
PHP log() HŽ 13.27 
PHP log10() 函数 13.28 
PHP log1p() Es 13.29 
PHP max() ER2X 13.30 
PHP min() E 13.31 
PHP mt getrandmax() 函数 13.32 
PHP mt rand() HŽ 13.33 
PHP mt srand() 函数 13.34 
PHP octdec() 函数 13.35 
PHP pi() 2X 13.36 
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PHP pow() Až 13.37 
PHP rad2deg() HFK 13.38 
PHP rand() 函数 13.39 
PHP round() 函数 13.40 
PHP sin() 函数 13.41 
PHP sinh() 函数 13.42 
PHP sqrt() EK 13.43 
PHP srand() Ez 13.44 
PHP tan() 函数 13.45 
PHP tanh() Až 13.46 
PHP 5 MySQLi HË 14 
PHP mysqli affected rows() 2X 14.1 
PHP mysqli_autocommit() 函数 14.2 
PHP mysgli change user() EK 14.3 
PHP mysgli character set name() 函数 14.4 
PHP mysqli close() EZ 14.5 
PHP mysqli commit() 函数 14.6 
PHP mysqli connect errno() 函数 14.7 
PHP mysgli connect error() 函数 14.8 
PHP mysgli connect() 函数 14.9 
PHP mysqli data seek() 2X 14.10 
PHP mysqli debug() 函数 14.11 
PHP mysqli dump debug info() 函数 14.12 
PHP mysqli_errno() 函数 14.13 
PHP mysali error list() 函数 14.14 
PHP mysqli_error() 函数 14.15 
PHP mysqli fetch all() ER 14.16 
PHP mysqli fetch array() Ex 14.17 
PHP mysgli fetch assoc() 函数 14.18 
PHP mysqli fetch field direct() 画 数 14.19 
PHP mysagli fetch field() 函数 14.20 
PHP mysali fetch fields() 函数 14.21 
PHP mysali fetch lengths() 函数 14.22 
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PHP mysali fetch object() 西数 14.23 
PHP mysali fetch. row() 函数 14.24 
PHP mysqli field count() 2X 14.25 
PHP mysqli field seek() 函数 14.26 
PHP mysqli field tell() 函数 14.27 
PHP mysgli free result() E32 14.28 
PHP mysqli get charset() 西数 14.29 
PHP mysqli get client info() 函数 14.30 
PHP mysali get client stats() 函数 14.31 
PHP mysqli get client version() 函数 14.32 
PHP mysali get connection stats() 函数 14.33 
PHP mysagli get connection stats() 函数 14.34 
PHP mysali get host info() 函数 14.35 
PHP mysgli get proto info() 函数 14.36 
PHP mysgli get server info() KIŠ 14.37 
PHP mysqli get server version() 2X 14.38 
PHP mysali info() 函数 14.39 
PHP mysgli init() 函数 14.40 
PHP mysagli insert id() 函数 14.41 
PHP mysqli_kill() FAžk 14.42 
PHP mysgli more results() 函数 14.43 
PHP mysqli multi query() 函数 14.44 
PHP mysgli next result() 函数 14.45 
PHP mysqli num fields() 2X 14.46 
PHP mysqli num rows() 函数 14.47 
PHP mysgli options() 函数 14.48 
PHP mysqli_ping() KIŠ 14.49 
PHP mysgli query() 函数 14.50 
PHP mysqli real connect() 函数 14.51 
PHP mysgli real escape string() 函数 14.52 
PHP mysqli refresh() 函数 14.53 
PHP mysgli rollback() 函数 14.54 
PHP mysgli select db() HŽ 14.55 
PHP mysgli set charset() 函数 14.56 
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PHP mysqli_sqlstate() 函数 14.57 
PHP mysgli ssl set() EK 14.58 
PHP mysali stat() 函数 14.59 
PHP mysqli stmt init() 函数 14.60 
PHP mysqli thread id() 函数 14.61 
PHP mysqli thread safe() 函数 14.62 
PHP PDO 15 
PHP PDO 预 定义 常量 15.1 
PHP PDO 连 接 15.2 
PHP PDO 事务 与 自动 提交 15.3 
PHP PDO 预 处 理 语 名 与 存储 过 程 15.4 
PHP PDO 错误 与 错误 处 理 15.5 
PHP PDO 大 对 象 (LOBs) 15.6 
PDO::beginTransaction 15.7 
PDO::commit 15.8 
PDO:: construct 15.9 
PDO::errorCode 15.10 
PDO::errorlnfo 15.11 
PDO::exec 15.12 
PDO::getAttribute 15.13 
PDO::getAvailableDrivers 15.14 
PDO::inTransaction 15:15 
PDO::lastlnsertld 15.16 
PDO::prepare 15.17 
PDO::guery 15.18 
PDO::guote 15.19 
PDO::rollBack 15.20 
PDO::setAttribute 15.21 
PDOStatement::bindColumn 15.22 
PDOStatement::bindParam 15.23 
PDOStatement::bindValue 15.24 
PDOStatement::closeCursor 15.25 
PDOStatement::columnCount 15.26 
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PDOStatement::debugDumpParams 15.27 
PDOStatement::errorCode 15.28 
PDOStatement::errorlnfo 15.29 
PDOStatement::execute 15.30 
PDOStatement::fetch 15.31 
PDOStatement::fetchAll 15.32 
PDOStatement::fetchColumn 15.33 
PDOStatement::fetchObject 15.34 
PDOStatement::getAttribute 15.35 
PDOStatement::getColumnMeta 15.36 
PDOStatement::nextRowset 15.37 
PDOStatement::rowCount 15.38 
PDOStatement::setAttribute 15.39 
PDOStatement::setFetchMode 15.40 
PHP SimpleXML Eg 16 
PHP  construct() 函数 16.1 
PHP addAttribute() 函数 16.2 
PHP addChild() 函数 16.3 
PHP asXML() 函数 16.4 
PHP attributes() Až 16.5 
PHP children() HŽ 16.6 
PHP getDocNamespaces() 函数 16.7 
PHP getName() 函数 16.8 
PHP getNamespace() 2X 16.9 
PHP registerXPathNamespace() HŽ 16.10 
PHP simplexml import dom() 函数 16.11 
PHP simplexml load file() 函数 16.12 
PHP simplexml load string() 2X 16.13 
PHP xpath() RIŽ 16.14 
PHP String 函数 17 
PHP addcslashes() Až 17.1 
PHP addslashes() EN 2% 17.2 
PHP bin2hex() 函数 17.3 
PHP chop() 函数 17.4 
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PHP chr() Egi 17.5 
PHP chunk split() 函数 17.6 
PHP convert cyr string() 函数 17.7 
PHP convert uudecode() RIŽ 17.8 
PHP convert uuencode() 函数 17.9 
PHP count chars() 函数 17.10 
PHP crc32() HŽ 17.11 
PHP crypt() 2X 1742 
PHP echo() Eit 17.13 
PHP explode() HŽ 17.14 
PHP fprintf() 函数 17.15 
PHP get html translation table() 函数 17.16 
PHP hebrev() HŽ 17.17 
PHP hebrevc() 函数 17.18 
PHP html entity decode() 函数 17.19 
PHP htmlentities() 函数 17.20 
PHP htmlspecialchars decode() Až 17.21 
PHP htmlspecialchars() 函数 17.22 
PHP implode() Až 17.23 
PHP join() 2X 17.24 
PHP levenshtein() 函数 17.25 
PHP localeconv() ER2& 17.26 
PHP Itrim() Eg 17.27 
PHP md5() Hat 17.28 
PHP md5 file() E 17.29 
PHP money format() 函数 17.30 
PHP nl langinfo() 函数 17.31 
PHP ni2br() 2K 17.32 
PHP number_format() 函数 17.33 
PHP ord() dž 17.34 
PHP parse str() 函数 17.35 
PHP print() AX 17.36 
PHP printf() aK 17.37 
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PHP quoted printable decode() Až 17.38 
PHP guotemeta() Až 17.39 
PHP rtrim() 函数 17.40 
PHP setlocale() 函数 17.41 
PHP sha1() 函数 17.42 
PHP sha1 file() 函数 17.43 
PHP similar text() 函数 17.44 
PHP soundex() HX 17.45 
PHP sprintf() 函数 17.46 
PHP sscanf() 函数 17.47 
PHP str ireplace() 函数 17.48 
PHP str pad() ZX 17.49 
PHP str repeat() 函数 17.50 
PHP str. replace() 函数 17.51 
PHP str rot13() 函数 17.52 
PHP str shuffle() 函数 17.53 
PHP str. split() 西数 17.54 
PHP str word count() 2X 17.55 
PHP strcasecmp() ER2X 17.56 
PHP strchr() 函数 17.57 
PHP strcmp() 函数 17.58 
PHP strcoll() EZ 17.59 
PHP strcspn() 函数 17.60 
PHP strip tags() EK 17.61 
PHP stripcslashes() 函数 17.62 
PHP stripslashes() 函数 17.63 
PHP stripos() 函数 17.64 
PHP stristr() 函数 17.65 
PHP strlen() 函数 17.66 
PHP strnatcasecmp() 函数 17.67 
PHP strnatcmp() 函数 17.68 
PHP strncasecmp() 函数 17.69 
PHP strncmp() 函数 17.70 
PHP strpbrk() 函数 17.71 
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PHP strpos() Fax 
PHP strrchr() AX 
PHP strrev() aX 
PHP strripos() 函数 
PHP strrpos() HX 
PHP strspn() AX 
PHP strstr() 函数 
PHP strtok() E#X 
PHP strtolower() 函数 


) ERR 


y 
" 


M— 一 


— 


PHP strtoupper 

PHP strtr() Eg 

PHP substr() aX 

PHP substr compare() HË 

PHP substr count() EZ 

PHP substr replace() HË 

PHP trim() aX 

PHP ucfirst() ES 

PHP ucwords() EZ 

PHP vfprintf() HŽ 

PHP vprintf() 函数 

PHP vsprintf() RIŽ 

PHP wordwrap() EZ 
PHP XML Parser HŽ% 

PHP utf8 decode() 函数 

PHP utf8 encode() HZ 


~ 


数 
PHP xml error string() EAžk 
PHP xml get current byte index() 函数 
PHP xml get current line number() 函数 
PHP xml get error code() Bax 
PHP xml parse() 函数 


PHP xml parse into struct() 函数 
函数 


PHP xml parser create ns() 


PHP xml parser create() 2X 


17.72 
17.73 
17.74 
17.75 
17.76 
17.77 
17.78 
17.79 
17.80 
17.81 
17.82 
17.83 
17.84 
17.85 
17.86 
17.87 
17.88 
17.89 
17.90 
17.91 
17.92 
17.93 
18 
18.1 
18.2 
18.3 
18.4 
18.5 
18.6 
18.7 
18.8 
18.9 
18.10 


18 


W3School PHP 参考 手册 


PHP xml parser free() 函数 18.11 
PHP xml parser get option() 函数 18.12 
PHP xml parser set option() ERgZX 18.13 
PHP xml set character data handler() 函数 18.14 
PHP xml set default handler() 函数 18.15 
PHP xml set element handler() 2X 18.16 
PHP xml set external entity ref handler() 西数 18.17 
PHP xml set notation decl handler() 函数 18.18 
PHP xml set object() 2X 18.19 
PHP xml set processing instruction handler() 函数 18.20 
PHP xml set unparsed entity decl handler() 函数 18.21 
PHP Zip File HŽ 19 
PHP zip close() 函数 19.1 
PHP zip entry close() 函数 19.2 
PHP zip entry compressedsize() 函数 19.3 
PHP zip entry compressionmethod() 西数 19.4 
PHP zip entry filesize() 函数 19.5 
PHP zip entry name() 函数 19.6 
PHP zip entry open() 函数 19.7 
PHP zip entry read() 函数 19.8 
PHP zip open() RX 19.9 
PHP zip read() 函数 19.10 
PHP 杀 项 函数 20 
PHP connection aborted() 函数 20.1 
PHP connection status() 函数 20.2 
PHP constant() 函数 20.3 
PHP define() 函数 20.4 
PHP defined() Eid 20.5 
PHP die() 函数 20.6 
PHP eval() HX 20.7 
PHP exit() 画 数 20.8 
PHP get browser() 函数 20.9 
PHP highlight file() Ej 20.10 
PHP highlight. string() 画 数 20.11 
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PHP ignore user abort() 函数 20.12 
PHP pack() FIŻ 20.13 
PHP strip whitespace() 函数 20.14 
PHP show. source() 函数 20.15 
PHP sleep() KIZ 20.16 
PHP time nanosleep() 函数 20.17 
PHP time sleep until() 西数 20.18 
PHP uniqid() EX 20.19 
PHP unpack() 函数 20.20 
PHP usleep() HŽ 20.21 
PHP 5 时 区 21 
免责 声明 22 
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来 源 : PHP 参考 手册 


整理 : 飞龙 


PHP Array 西数 


PHP Array 简介 


array PAR jo 41K x UB TIRE. 


PHP 支持 单 维和 多 维 的 数组 。 同 时 提供 了 用 数据 库 查询 结果 来 构造 数组 的 画 数 。 


dná 


ra 


array Re PHP 核心 的 组 成 部 分 。 无 需 安 装 即 可 使 用 这 些 函 数 。 


PHP Array 西数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


Eska 


array() 


array change key case() 


array chunk() 

array combine() 
array count values() 
array diff() 
array diff assoc() 


array diff key() 
array diff uassoc() 


array diff ukey() 

array fill() 

array filter() 

array flip() 

array intersect() 

array intersect assoc() 


array intersect key() 


描述 
创建 数组 。 
返回 其 键 均 为 大 写 或 小 写 的 数组 。 
把 一 个 数组 分 割 为 新 的 数组 块 。 
通过 合并 两 个 数组 来 创建 一 个 新 数组 。 
用 于 统计 数组 中 所 有 值 出 现 的 次 数 。 
返回 两 个 数组 的 差 集 数组 。 
比较 键 名 和 键 值 ， 并 返回 两 个 数组 的 差 集 数组 。 
比较 键 名 ， 并 返回 两 个 数组 的 差 集 数 组 。 
过 用 户 提 供 的 回调 函数 做 索引 检查 来 计算 数组 的 


o 


用 回调 函数 对 键 名 上 比较 计算 数组 的 差 集 。 


用 给 定 的 值 填充 数组 。 

用 回调 画 数 过 滤 数 组 中 的 元 素 。 
交换 数组 中 的 键 和 值 。 

计算 数组 的 交集 。 


比较 键 名 和 键 值 ， 并 返回 两 个 数组 的 交集 数组 。 
使 用 键 名 比较 计算 数组 的 交集 。 


PHP 


四 | 人 | 下 | 人 | 四 | 下 | 下 |w 
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W3School PHP 参考 手册 


array intersect uassoc() 


array intersect ukey() 
array key exists() 

array keys() 

array map() 

array merge() 

array merge recursive() 
array multisort() 

array pad() 

array pop() 


array product() 
array push() 


array rand() 


array reduce() 


array reverse() 


array search() 


array shift() 


array. slice() 
array splice() 
array sum() 


array udiff() 


array udiff assoc() 


array udiff uassoc() 
array uintersect() 


array uintersect assoc() 


array uintersect uassoc() 


PHP Array EX 


带 索 引 检查 计算 数组 的 交集 ， 用 回调 函数 比较 索 
引 。 


用 回调 函数 比较 键 名 来 计算 数组 的 交集 。 
检查 给 定 的 键 名 或 索引 是 否 存 在 于 数组 中 。 
返回 数组 中 所 有 的 键 名 。 

将 回调 函数 作用 到 给 定数 组 的 单元 上 。 

把 一 个 或 多 个 数组 合并 为 一 个 数组 。 

递归 地 合并 一 个 或 多 个 数组 。 

对 多 个 数组 或 多 维 数组 进行 排序 。 

用 值 将 数组 填补 到 指定 长 度 。 

将 数组 最 后 一 个 单元 弹出 〈 出 栈 ) 。 

计算 数组 中 所 有 值 的 乘积 。 
将 一 个 或 多 个 单元 〈 元 素 ) A 
栈 ) 。 

从 数组 中 随机 选 出 一 个 或 多 个 元 素 ， 并 返回 。 
用 回调 函数 迭代 地 将 数组 简化 为 单一 的 值 。 


将 原 数 组 中 的 元 素 顺 序 翻转 ， 创 建新 的 数组 并 返 
回 。 


在 数组 中 搜索 给 定 的 值 


o 


出 除数 组 中 的 第 
值 。 


在 数组 中 根据 条 件 取出 一 段 值 ， 并 返回 。 

把 数组 中 的 一 部 分 去 掉 并 用 其 它 值 取代 。 

计算 数组 中 所 有 值 的 和 。 

用 回调 男 数 比较 数据 来 计算 数组 的 差 集 。 
EE RENA ER LEG Š 


o 


入 数组 的 末尾 (A 


一 个 元 素 ， 并 返回 被 删除 元 素 的 


带 索 引 检 查 计 算数 组 的 差 集 ， 用 回调 函数 比较 数据 


和 索引 。 
计算 数组 的 交集 ， 用 回调 琅 数 比较 数据 。 


带 索 引 检 查 计算 数组 的 交集 ， 用 回调 函数 比较 数 
据 。 


带 索 引 检查 计算 数组 的 交集 ， 用 回调 函数 比较 数据 


和 索引 。 


， 如 果 成 功 则 返回 相应 的 键 


o 8 nl s [ES s ee) s NUM a 


A 


b 


array unigue() 
array unshift() 


array values() 


array walk() 


array walk recursive() 


arsort() 
asort() 
compact() 
count() 


current() 
each() 


end() 
extract() 
in array() 
key() 
krsort() 
ksort() 
list() 


natcasesort() 


natsort() 
next() 
pos() 
prev() 
range() 
reset() 
rsort() 
shuffle() 
sizeof() 


sort() 


uasort() 


删除 数组 中 重复 的 值 。 

在 数组 开头 插入 一 个 或 多 个 元 素 。 
返回 数组 中 所 有 的 值 。 

对 数组 中 的 每 个 成 员 应 用 用 户 函 数 。 

对 数组 中 的 每 个 成 员 递 为 地 应 用 用 户 汞 数 。 
对 数组 进行 逆向 排序 并 保持 索引 关系 。 

对 数组 进行 排序 并 保持 索引 关系 。 

建立 一 个 数组 ， 包 括 变量 名 和 它们 的 值 。 
计算 数组 中 的 元 素数 目 或 对 象 中 的 属性 个 数 。 
返回 数组 中 的 当前 元 素 。 

返回 数组 中 当前 的 键 二 值 对 并 将 数组 指针 向 前 移动 


一 步 。 

将 数组 的 内 部 指针 指向 最 后 一 个 元 素 。 
从 数组 中 将 变量 导入 到 当前 的 符号 表 。 
检查 数组 中 是 否 存 在 指定 的 值 。 

从 关联 数组 中 取得 键 名 。 

对 数组 按照 键 名 逆向 排序 。 

对 数组 按照 键 名 排序 。 

把 数组 中 的 值 赋 给 一 些 变量 。 


用 “自然 排序 "算法 对 数组 进行 不 区 分 大 小 写字 母 的 
排序 。 


用 “自然 排序 ”算法 对 数组 排序 。 

将 数组 中 的 内 部 指针 向 前 移动 一 位 。 
current() 的 别名 。 

将 数组 的 内 部 指针 倒 回 一 位 。 

建立 一 个 包含 指定 范围 的 元 素 的 数组 。 
将 数组 的 内 部 指针 指向 第 一 个 元 素 。 
对 数组 逆向 排序 。 

把 数组 中 的 元 素 按 随机 顺序 重新 排列 。 
count() 的 别名 。 

对 数组 排序 。 


使 用 用 户 自 定义 的 比较 本 数 对 数组 中 的 值 进行 排序 
并 保持 索引 关联 。 





C U A U U U U AB A 
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CD 


使 用 用 户 自 定义 的 比较 图 数 对 数组 中 的 键 名 进行 排 


uksort() E 3 
Tort) cs PATE SU BY EG EE PR SU BY 4a RAT f s AT HE 3 
PHP Array 常量 
PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 
常量 描述 PHP 
用 在 array change key case() 中 将 数组 键 名 转 
CASE LOWER ah Se. 
用 在 array change key case() 中 将 数组 键 名 转 
CASE UPPER eae 
SORT_ASC FA array multisort() 函数 中 ， 使 其 升序 排列 。 
SORT DESC FA array multisort() 函数 中 ， 使 其 降序 排列 。 
SORT_REGULAR 用 于 对 对 象 进 行 通常 比较 。 
SORT NUMERIC 用 于 对 对 象 进行 数值 比较 。 
SORT STRING 用 于 对 对 象 进行 字符 串 比 较 。 
SORT LOCALE STRING 基于 当前 区 域 来 对 对 象 进行 字符 串 比 较 。 4 


COUNT NORMAL 

COUNT RECURSIVE 
EXTR OVERWRITE 

EXTR SKIP 

EXTR PREFIX SAME 
EXTR PREFIX ALL 

EXTR PREFIX INVALID 
EXTR PREFIX IF. EXISTS 
EXTR IF EXISTS 

EXTR REFS 


PHP array() 


定义 和 用 法 


array() 创建 数组 ， 带 有 键 和 值 。 如 果 在 规定 数组 时 省 略 了 键 ， 则 生成 一 个 整数 键 ， 这 个 key 
从 0 开始 ， 然 后 以 1 进行 递增 。 


要 用 array() 创建 一 个 关联 数组 ， 可 使 用 => 来 分 隔 键 和 值 。 


要 创建 一 个 空 数组 ， 则 不 传递 参数 给 array() : 


$new = array(); 


注意 : array() 实际 上 是 一 种 语言 结构 (language construct)， 通 常用 来 定义 直接 量 数组 ， 但 它 
的 用 法 和 画 数 的 用 法 很 相似 ， 所 以 我 们 把 它 也 列 到 手册 中 。 


语法 


array(key => value) 


参数 描述 
key 可 选 。 规 定 key， 类 型 是 数值 或 字符 串 。 如 果 未 设置 ， 则 生成 整数 类 型 的 key, 
value ”必需 。 规 定 值 。 
例子 1 
<?php 
$a=array("a"=>"Dog", "b"=>"Cat", "c"=>"Horse"); 


print_r($a); 
?> 


输出 : 


Array ( [a] => Dog [b] => Cat [c] => Horse ) 


例子 2 


<?php 
$azarray( "Dog", "Cat", "Horse"); 
print r($a); 

?> 


输出 : 


Array ( [0] => Dog [1] => Cat [2] => Horse ) 


PHP array change key case() 2 


ch 、 S 
array change key case() 函数 将 数组 的 所 有 的 KEY 都 转换 为 大 写 或 小 写 。 
数组 的 数字 索引 不 发 生变 化 。 如 果 未 提供 可 选 参数 〈 即 第 二 个 参数 ) ， 则 默认 转换 为 小 写字 


array change key case(array,case) 


参数 描述 
array ， 必需。 规定 要 使 用 的 数组 。 


可 选 。 可 能 的 值 : CASE LOWER - 默认 值 。 以 小 写字 母 返 回 数组 的 键 。 


cane CASE UPPER - 以 大 写字 母 返回 数组 的 键 。 


提示 和 注释 : 


注释 : 如 果 在 运行 该 本 数 时 两 个 或 多 个 键 相 同 ， 则 最 后 的 元 素 会 覆盖 其 他 元 素 (参见 例子 
2) o 


例子 1 


<?php 

$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Horse"); 
print r(array change key case($a, CASE UPPER)), 
?> 


输出 : 


Array ( [A] => Cat [B] => Dog [C] => Horse ) 


例子 2 


<?php 

$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Horse", "p'-2'"Birgd" Jún 
print r(array change key case($a, CASE UPPER)), 

?> 


输出 : 


Array ( [A] => Cat [B] => Bird [C] => Horse ) 


PHP array chunk() 函数 


= ~ N 
array chunk() 函数 把 一 个 数组 分 割 为 新 的 数组 块 。 
其 中 每 个 数组 的 单元 数目 由 size 参数 决定 。 最 后 一 个 数组 的 单元 数目 可 能 会 少 几 个 。 


可 选 参 数 di udis key 是 一 个 布尔 值 ， 它 指定 新 数组 的 元 素 是 否 有 和 原 数 组 相同 的 键 (用 于 
关联 数组 ) ， 还 是 从 0 开始 的 新 数字 键 〈 用 于 索引 数组 ) 。 黑 认 是 分 配 新 的 键 。 


语法 


array chunk(array, size, preserve key) 


参数 描述 
array 1 规定 要 使 用 的 数组 。 
规定 每 个 新 数组 包含 多 少 个 元 素 。 


fo 

size 必需 。 规 

H 3b. 可 能 的 值 : _ true Fus 原始 数组 中 的 键 名 。 false - 默认 。 每 
ERB 


preserve_key ^ 


例子 1 


<?php 

$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Horse", "d"=>"Cow"); 
print r(array chunk($a, 2)); 

?> 


输出 : 


Array ( 

[0] => Array ( [0] => Cat [1] => Dog ) 
[1] => Array ( [0] => Horse [1] => Cow ) 
) 


例子 2 


<?php 
$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Horse", "d"=>"Cow"); 


print r(array chunk($a,2,true)); 
?> 


输出 : 


Array ( 

[0] => Array ( [a] => Cat [b] => Dog ) 
[1] => Array ( [c] => Horse [d] => Cow ) 
) 


PHP array combine() E325 


定义 和 用 法 


array combine() 函数 通过 合并 两 个 数组 来 创建 一 个 新 数组 ， 其 中 的 一 个 数组 是 键 名 ， 另 一 个 
数组 的 值 为 键 值 。 


如 果 其 中 一 个 数组 为 空 ， 或 者 两 个 数组 的 元 素 个 数 不 同 ， 则 该 落 数 返回 false, 


语法 


array combine(arrayl,array2) 


参数 描述 
array1 必需 。 规 定 键 名 。 
array2 必需 。 规 定 值 。 


提示 和 注释 


注释 : 两 个 参数 必须 有 相同 数目 的 元 素 。 


例子 


<?php 

$al-array( Maus UDES vou? "g"); 
$a2-array("Cat", "Dog", "Horse", "Cow"); 
print r(array combine($a1,$a2)); 

?> 


输出 : 


Array ( [a] => Cat [b] => Dog [c] => Horse [d] => Cow ) 


PHP array count values() HŽ% 


m. : 
array count values() 函数 用 于 统计 数组 中 所 有 值 出 现 的 次 数 。 
本 画 数 返回 一 个 数组 ， 其 元 素 的 键 名 是 原 数组 的 值 ， 键 值 是 该 值 在 原 数组 中 出 现 的 次 数 。 


语法 


array count values(array) 


array 必需 。 规 定 输入 的 数组 。 


例子 


<?php 
$a-array("Cat", "Dog", "Horse", "Dog"); 
print r(array count values($a)); 

?> 


输出 : 


Array ( [Cat] => 1 [Dog] => 2 [Horse] => 1 ) 


PHP array diff() H2X 


定义 和 用 法 


array diff() 范 数 返回 两 个 数组 的 差 集 数 组 。 该 数组 包括 了 所 有 在 被 比较 的 数组 中 ， 但 是 不 在 
任何 其 他 参数 数组 中 的 键 值 。 


在 返回 的 数组 中 ， 键 名 保持 不 变 。 


语法 


array diff(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 


提示 和 注释 
提示 : 可 用 一 个 或 任意 多 个 数组 与 第 一 个 数组 进行 比较 。 


注释 : 仅 有 值 用 于 比较 。 


例子 


<?php 
$alzarray(0->"Cat",1->"Dog",2->"Horse"), 
$a2=array(3=>"Horse", 4=>"Dog",5=>"Fish"); 
print r(array diff($a1,$a2)); 

?> 


输出 : 


Array ( [0] => Cat ) 


PHP array diff assoc() 函数 


定义 和 用 法 


array diff assoc() 范 数 返回 两 个 数组 的 差 集 数 组 。 该 数组 包括 了 所 有 在 被 比较 的 数组 中 ， 但 
是 不 在 任何 其 他 参数 数组 中 的 键 和 值 。 


和 array_diff() 函数 不 同 ， 本 画 数 要 求 键 名 和 键 值 都 进行 比较 。 返 回 的 数组 中 键 名 保持 不 变 。 


语法 


array diff assoc(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 


提示 和 注释 
提示 : 可 用 一 个 或 任意 多 个 数组 与 第 一 个 数组 进行 比较 。 


注释 : 键 和 值 都 用 于 比较 。 


例子 


<?php 
$alzarray(0->"Cat",1->"Dog",,2->"Horse"), 
$a2-array(0->"Rat", 1->"Horse",,2->"Dog"),: 
$a3-array(0-»"Horse",1-»"Dog",2-»"Cat"); 
print r(array diff assoc($al1, $a2, $a3)), 
?» 


输出 : 


Array ( [0] => Cat [2] => Horse ) 


PHP array diff key() 函数 


定义 和 用 法 


array diff key() 函数 返回 一 个 数组 ， 该 数组 包括 了 所 有 在 被 比较 的 数组 中 ， 但 是 不 在 任何 其 
他 参数 数组 中 的 键 。 


语法 


array diff key(arrayd,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 


E 一 Mrs 
提示 和 LER 
提示 : 可 用 一 个 或 任意 多 个 数组 与 第 一 个 数组 进行 比较 。 
注释 : 仅仅 键 名 用 于 比较 。 


例子 


<?php 
$alzarray(0->"Cat",1->"Dog",2->"Horse"), 
$a2=array(2=>"Bird", 3=>"Rat", 4=>"Fish"); 
$a3=array(5=>"Horse", 6=>"Dog", 7=>"Bird"); 
print r(array diff key($a1, $a2, $a3)); 

?> 


输出 : 


Array ( [0] => Cat [1] => Dog ) 


PHP array diff uassoc() EAižk 


= ~ ` 

定义 和 用 法 

arraydiff uassoc() 函数 使 用 用 户 自 定义 的 回调 函数 (callback) 做 索引 检查 来 计算 两 个 或 多 个 
数组 的 差 集 。 返 回 一 个 数组 ， 该 数组 包括 了 在 arayf 中 但 是 不 在 任何 其 他 参数 数组 中 的 
值 。 

注意 ， 与 array_diff() 西数 不 同 的 是 ， 键 名 也 要 进行 比较 。 

参数 function 是 用 户 自 定 义 的 用 来 比较 两 个 数组 的 函数 ， 该 范 数 必 须 带 有 两 个 参数 - 即 两 个 
Beat thee. AHSAN array diff assoc() 的 行为 正好 相反 ， 后 者 是 用 内 部 函数 进行 
比较 的 。 


返回 的 数组 中 键 名 保持 不 变 。 


语法 
array diff uassoc(arraydi,array2,array3...,function) 
参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 
function 必需 。 用 户 自 定 义 函 数 的 名 称 。 


例子 1 


<?php 
function myfunction($v1, $v2) 


{ 
if ($vi---$v2) 
return 0; 


} 
if ($v1>$v2) 


return 1; 
} 

else 
{ 
return -1; 
} 

} 


$ail=array(0=>"Dog",1=>"Cat", 2=>"Horse"); 

$a2=ar ray (3=>"Dog",1=>"Cat",5=>"Horse"); 

print r(array diff uassoc($a1,$a2, "myfunction")); 
?> 


输出 : 


Array ( [0] => Dog [2] => Horse ) 


例子 2 
ANA] 75 RBM AS DNA. : 


«?php 
function myfunction($v1, $v2) 


{ 
if ($v1===$v2) 
{ 


return 0; 


} 
if ($v1>$v2) 
{ 


return 1; 


J 


else 


{ 


return -1; 

} 
J 
$al-zarray(0->"Dog", 1->"Cat",2->"Horse"), 
$a2-array(3->"Dog",1->"Cat",5->"Horse"), 
$a3-array(6-»"Bird",0-»"Dog",5-»"Horse"); 
print r(array diff uassoc($a1, $a2, $a3, "myfunction")); 
?> 


输出 : 


Array ( [2] => Horse ) 


PHP array diff ukey() E325 


定义 和 用 法 


array diff ukey() 返回 一 个 数组 ， 该 数组 包括 了 所 有 出 现在 array1 中 但 是 未 出 现在 任何 其 它 
参数 数组 中 的 键 名 的 值 。 注 意 关 联 关 系 保留 不 变 。 与 array_diff() 不 同 的 是 ， 比 较 是 根据 键 名 
而 不 是 值 来 进行 的 。 


此 比较 是 通过 用 户 提 供 的 回调 画 数 来 进行 的 。 如 果 认 为 第 一 个 参数 小 于 ， 等 于 ， 或 大 于 第 二 
个 参数 时 必须 分 别 返 回 一 个 小 于 需 ， 等 于 需 ， 或 大 于 替 的 整数 。 


语法 
array diff ukey(array1,array2,array3..., function) 
参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 
function 必需 。 用 户 自 定 义 函 数 的 名 称 。 


例子 1 


<?php 
function myfunction($v1,$v2) 


{ 

if ($v1===$v2) 
{ 
return 0, 
J 

if ($vi>$v2) 
{ 


return 1; 
} 
else 
{ 
return -1, 


J 


$al-zarray(0->"Dog",1->"Cat",2->"Horse"), 
$a2=array(3=>"Rat",1=>"Bird", 5=>"Monkey"); 
print r(array diff ukey($a1, $a2, "myfunction")), 
?> 


输出 : 


Array ( [0] => Dog [2] => Horse ) 


例子 2 
ANA] 75 3x ES 26 723 AS DNA. : 


«?php 
function myfunction($v1, $v2) 


{ 
if ($vi---$v2) 
{ 


return 0; 


} 
if ($v1>$v2) 
{ 


return 1; 


J 


else 


t 


return -1; 

} 
} 
$al-zarray(0->"Dog",1->"Cat",2->"Horse"), 
$a2=array(3=>"Rat",1=>"Bird", 5=>"Monkey"); 
$a3=ar ray (6=>"Dog", 7=>"Donkey", 0=>"Horse" ); 
print r(array diff ukey($a1, $a2, $a3, "myfunction")); 
?> 


输出 : 


Array ( [2] => Horse ) 


PHP array fill() HŽ% 


定义 和 用 法 


array fill() 画 数 用 给 定 的 值 填充 数组 ， 返 回 的 数组 有 number 个 元 素 ， 值 为 value。 返 回 的 数 
组 使 用 数字 索引 ， 从 start 位 置 开 始 并 递增 。 如 果 number 为 0 或 小 于 0， 就 会 出 错 。 


语法 


array fill(start, number, value) 


参数 描述 
start 必需 。 数 值 ， 规 定 键 的 起 始 索 引 。 
number 必需 。 数 值 ， 规 定 填 充 的 数量 ， 其 值 必须 大 于 0。 
value 必需 。 规 定 要 插入 的 值 。 


例子 


<?php 

$a-array fill(2,3,"Dog"); 
print r($a); 

?» 


输出 : 


Array ( [2] => Dog [3] => Dog [4] => Dog ) 


PHP array filter() 2X 


中 、 : 
定义 和 用 法 
array filter() 芳 数 用 回调 图 数 过 滤 数 组 中 的 元 素 ， 如 果 自 定义 过 滤 图 数 返 回 true， 则 被 操作 的 


数组 的 当前 值 就 会 被 包含 在 返回 的 结果 数组 中 ， 并 将 结果 组 成 一 个 新 的 数组 。 如 果 原 数组 是 
一 个 关联 数组 ， 键 名 保持 不 变 。 


语法 


array filter(array, function) 


参数 描述 
array 必需 。 规 定 输入 的 数组 。 
function 必需 。 自 定义 函数 的 名 称 。 


例子 


<?php 
function myfunction($v) 


if ($v==="Horse") 

return true; 
return false; 
$azarray(0->"Dog",1->"Cat",2->"Horse"), 


print r(array filter($a, "myfunction")), 
?> 


输出 : 


Array ( [2] => Horse ) 


PHP array flip() E325 


定义 和 用 法 


array flip() 画 数 返回 一 个 反 转 后 的 数组 ， 如 果 同 一 值 出 现 了 多 次 ， 则 最 后 一 个 键 名 将 作为 它 
的 值 ， 所 有 其 他 的 键 名 都 将 丢失 。 


如 果 原 数组 中 的 值 的 数据 类 型 不 是 字符 串 或 整数 ， 画 数 将 报错 。 


语法 


array_flip(array) 


array 必需 。 规 定 输入 的 数组 。 


例子 


<?php 
$a=array(0=>"Dog",1=>"Cat",2=>"Horse");print_r(array_flip($a)); 
?> 


输出 : 


Array ( [Dog] => 0 [Cat] => 1 [Horse] => 2 ) 


PHP array intersect() 2X 


定义 和 用 法 


array intersect() 函数 返回 两 个 或 多 个 数组 的 交集 数组 。 


结果 数组 包含 了 所 有 在 被 比较 数组 中 ， 也 同时 出 现在 所 有 其 他 参数 数组 中 的 值 ， 键 名 保留 不 


a. 
注释 : 仅 有 值 用 于 比较 。 


语法 


array intersect(array1,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 


例子 


<?php 
$a1=array(0=>"Cat",1=>"Dog",2=>"Horse"); 
$a2=array(3=>"Horse",4=>"Dog",5=>"Fish"); 
print_r(array_intersect($a1, $a2)); 

?> 


输出 : 


Array ( [1] => Dog [2] => Horse ) 


PHP array intersect assoc() Ki 


re. : 
array_intersect_assoc() 函数 返回 两 个 或 多 个 数组 的 交集 数组 。 


与 array_intersect() 函数 不 同 的 是 ， 本 函数 除了 上 比较 键 值 ， 还 比较 键 名 。 返 回 的 数组 中 元 素 
的 键 名 保持 不 变 。 


语法 


array intersect assoc(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 


例子 1 


<?php 

$alzarray(0->"Cat", 1->"Dog",2->"Horse"), 
$a2=array(3=>"Horse",1=>"Dog", 0=>"Cat"); 
print r(array intersect assoc($a1,$a2)); 
?» 


Array ( [0] -» Cat [1] -» Dog ) 


例子 2 


<?php 
$alzarray(0->"Cat",1->"Dog",2->"Horse"), 
$a2=array(3=>"Horse",1=>"Dog",5=>"Fish"); 
$a3=ar ray (6=>"Cow", 1=>"Dog", 8=>"Fish"); 
print_r(array_intersect_assoc($a1,$a2,$a3)); 
?» 
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输出 : 


Array ( [1] => Dog ) 


PHP array intersect assoc() 函数 
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PHP array intersect key() HŽ% 


定义 和 用 法 
array intersect key() 画 数 使 用 键 名 上 比较 计算 数组 的 交集 。 


array_intersect_key() 返回 一 个 数组 ， 该 数组 包含 了 所 有 出 现在 被 比较 的 数组 中 并 同时 出 现在 
所 有 其 它 人 参数 数组 中 的 键 名 的 值 。 


注释 : 仅 有 键 名 用 于 比较 。 
语法 


array intersect key(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 


例子 1 


<?php 
$alzarray(0->"Cat",1->"Dog",2->"Horse"), 
$a2=array(2=>"Bird", 0=>"Cat", 4=>"Fish"); 
print_r(array_intersect_key($a1,$a2)); 
?> 


输出 : 


Array ( [0] => Cat [2] => Horse ) 


例子 2 


<?php 
$al-zarray(0->"Cat",1->"Dog",2->"Horse"), 
$a2=array(2=>"Bird", 3=>"Rat", 4=>"Fish"); 
$a3=ar ray (2=>"Dog", 6=>"Cow", 7=>"Bird"); 
print r(array intersect key($a1,$a2,$a3)); 
?> 


输出 : 


Array ( [2] => Horse ) 


PHP array intersect uassoc() 函数 


定义 和 用 法 
array intersect uassoc() 琅 数 使 用 用 户 自 定义 的 回调 函数 计算 数组 的 交集 ， 用 回调 函数 比较 
索引 。 


arrayintersect uassoc() 返回 一 个 数组 ， 该 数组 包含 了 所 有 在 array 中 也 同时 出 现在 所 有 其 
它 参 数 数组 中 的 值 。 返 回 的 数组 中 键 名 保持 不 变 。 


$a, 4§ array intersect() 不 同 的 是 除了 上 比较 键 值 ， 还 要 比较 键 名 。 


此 比较 是 通过 用 户 提供 的 回调 函数 来 进行 的 。 该 函数 带 有 两 个 参数 ， 即 两 个 要 进行 对 比 的 键 
名 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 要 返回 一 个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返 
El 0， 如 果 第 一 个 参数 大 于 第 二 个 参数 ， 则 返回 一 个 正 数 。 


语法 
array intersect uassoc(array1,array2,array3..., function) 
参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 
function 用 户 自 定 义 范 数 的 名 称 。 


例子 1 


<?php 
function myfunction($v1,$v2) 


t 
if ($vi---$v2) 
return 0; 


} 
if ($v1>$v2) 


return 1; 
} 

else 
{ 
return -1, 
} 

} 


$ail=array(0=>"Dog",1=>"Cat", 2=>"Horse"); 
$a2=array(3=>"Dog",1=>"Cat",5=>"Horse"); 

print r(array intersect uassoc($a1, $a2, "myfunction")), 
?> 


输出 : 


Array ( [1] => Cat ) 


例子 2 
如 何 为 函数 分 配 多 个 数组 : 


<?php 
function myfunction($v1, $v2) 


{ 
if ($v1---$v2) 
{ 


return 0; 


} 
if ($v1>$v2) 
{ 


return 1; 


J 


else 


{ 

return -1; 

} 
J 
$al-zarray(0->"Dog",1->"Cat",2->"Horse"), 
$a2=array(0=>"Dog",1=>"Cat",5=>"Horse"); 
$a3=array(6=>"Bird", 0=>"Dog", 5=>"Horse"); 
print r(array intersect uassoc($a1, $a2, $a3, "myfunction")); 
?> 


输出 : 


Array ( [0] => Dog ) 


PHP array intersect ukey() 2X 
定义 和 用 法 


array intersect ukey() 函数 用 回调 函数 比较 键 名 来 计算 数组 的 交集 。 


array intersect ukey() 返回 一 个 数组 ， 该 数组 包含 了 所 有 出 现在 array1 中 并 同时 出 现在 所 有 
其 它 参 数 数组 中 的 键 名 


此 比较 是 通过 用 户 提供 的 回调 函数 来 进行 的 。 该 函数 带 有 两 个 参数 ， 即 两 个 要 进行 对 比 的 键 
名 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 要 返回 一 个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返 
El 0， 如 果 第 一 个 参数 大 于 第 二 个 参数 ， 则 返回 一 个 正 数 。 


语法 
array intersect uassoc(array1,array2,array3..., function) 
参数 描述 
array1 必需 。 与 其 他 数组 进行 比较 的 第 一 个 数组 。 
array2 必需 。 与 第 一 个 数组 进行 比较 的 数组 。 
array3 可 选 。 与 第 一 个 数组 进行 比较 的 数组 。 可 以 有 多 个 。 
function 用 户 自 定义 函数 的 名 称 。 


例子 1 


<?php 
function myfunction($v1,$v2) 


t 
if ($vi---$v2) 
return 0; 


} 
if ($v1>$v2) 


return 1; 
} 

else 
{ 
return -1, 
} 

} 


$ai=array(0=>"Dog",1=>"Cat", 2=>"Horse"); 
$a2=array(3=>"Rat",1=>"Bird", 5=>"Monkey"); 

print r(array intersect ukey($a1,$a2, "myfunction")); 
?> 


输出 : 


Array ( [1] => Cat ) 


例子 2 
如 何 为 函数 分 配 多 个 数组 : 


<?php 
function myfunction($v1, $v2) 


{ 
if ($v1===$v2) 
{ 


return 0; 


} 
if ($v1>$v2) 
{ 


return 1; 


J 


else 


{ 

return -1; 

} 
J 
$al-zarray(0->"Dog",1->"Cat",2->"Horse"), 
$a2-array(0-»"Rat",1-»"Bird",5-»"Monkey"); 
$a3zarray(6->"Dog", 7=>"Donkey", 0=>"Horse"); 
print r(array intersect ukey($a1,$a2,$a3, "myfunction")), 
?> 


输出 : 


Array ( [0] => Dog ) 


PHP array key exists() 2 


定义 和 用 法 


array key exists() 函数 判断 某 个 数组 中 是 否 存在 指定 的 key， 如 果 该 key 存在 ， 则 返回 
true， 否 则 返回 false, 


语法 


array key exists(key,array) 


key WF 


= 
TI 
array 必需 。 规 


例子 1 


<?php 
$a=array( "a"=>"Dog", In pu — coat ) T 
if (array key exists("a",$a)) 


echo "Key exists!"; 
H 
else 
echo "Key does not exist!"; 


J 


?> 


输出 : 


Key exists! 


例子 2 


<?php 
$azarray( "a"=>"Dog", put Cate ) ; 
if (array key exists("c",$a)) 


echo "Key exists!"; 


J 


else 


echo "Key does not exist!"; 


J 


2» 


输出 : 


Key does not exist! 


例子 2 


<?php 
$a=array("Dog",Cat"); 
if (array_key_exists(0, $a) ) 


echo "Key exists!"; 


J 


else 


{ 


echo "Key does not exist!"; 


} 


?> 


输出 : 


Key exists! 


PHP array keys() 2X 


ch 、 S 
定义 和 用 法 

array keys() 豆 数 返回 包含 数组 中 所 有 键 名 的 一 个 新 数组 。 

如 果 提供 了 第 二 个 参数 ， 则 只 返回 键 值 为 该 值 的 键 名 。 

如 果 strict 参数 指定 为 true， 则 PHP 会 使 用 全 等 比较 (===) 来 严格 检查 键 值 的 数据 类 型 。 


语法 
array keys(array, value) 
参数 描述 
array ”必需 。 规 定 输入 的 数组 。 


value ， 可 选 。 指 定 值 的 索引 ( 键 ) 。 


可 选 。 与 value 参数 一 起 使 用 。 可 能 的 值 : true -根据 类 型 返回 带 有 指定 值 的 


strict | 键 名 。 false -默认 值 。 不 依赖 类 型 。 


例子 1 


<?php 

$a=array("a"=>"Horse", "b"=>"Cat", "c"z»"Dog"); 
print r(array keys($a)); 

?> 


输出 : 


Array ( [0] => a [1] => b [2] => c ) 


例子 2 
使 用 value 参数 : 


<?php 

$a=array("a"=>"Horse", abu Cate "c"z»"Dog"); 
print r(array keys($a, "Dog")); 

?> 


输出 : 


Array ( [0] => c) 


例子 3 
使 用 strict 参数 (false) : 


<?php 

$azarray(10,20, 30, "10"), 

print r(array keys($a, "10",false)), 
?> 


输出 : 


Array ( [0] => 0 [1] => 3 ) 


例子 4 
使 用 strict 参数 (true) : 


«?php 

$a-array(10,20,30,"10"); 

print r(array keys($a, "10",true)); 
?> 


输出 : 


Array ( [0] => 3) 


PHP array map() HŽ 


定义 和 用 法 


array_map() 琅 数 返回 用 户 自 定 义 函 数 作用 后 的 数组 。 回 调 函 数 接受 的 参数 数目 应 该 和 传递 给 
array map() 画 数 的 数组 数目 一 致 。 


语法 


array map(function,arraydi,array2,array3...) 


参数 描述 
function 必需 。 用 户 自 定义 汞 数 的 名 称 ， 或 者 是 null。 
array1 必需 。 规 定数 组 。 
array2 可 选 。 规 定数 组 。 
array3 可 选 。 规 定数 组 。 


例子 1 


<?php 
function myfunction($v) 


t 
if ($v==="Dog") 
return "Fido"; 
return $v; 
} 
$a=array("Horse", "Dog", "Cat"); 


print r(array map("myfunction",$a)); 
?> 


输出 : 


Array ( [0] => Horse [1] => Fido [2] => Cat ) 


例子 2 


使 用 多 个 参数 : 


<?php 
function myfunction($v1, $v2) 


{ 
if ($v1===$v2) 
return "same"; 


return "different"; 

} 

$ai1-array("Horse", "Dog", "Cat"); 
$a2-array("Cow", "Dog", "Rat"); 

print r(array map("myfunction",$a1,3$a2)); 
?> 


输出 : 


Array ( [0] => different [1] => same [2] => different ) 


例子 3 
请 看 当 自 定义 函数 名 设置 为 null 时 的 情况 : 


<?php 

$ai1-array("Dog", "Cat"); 
$a2-array("Puppy", "Kitten"); 
print r(array map(null,$a1,$a2)); 
?> 


输出 : 


Array ( 

[0] => Array ( [0] => Dog [1] => Puppy ) 
[1] => Array ( [0] => Cat [1] => Kitten ) 
) 


PHP array merge() 函数 


= 、 : 
定义 和 用 法 
array merge() 函数 把 两 个 或 多 个 数组 合并 为 一 个 数组 。 


如 果 键 名 有 重复 ， 该 键 的 键 值 为 最 后 一 个 键 名 对 应 的 值 〈 后 面 的 履 盖 前 面 的 ) 。 如 果 数 组 是 
数字 索引 的 ， 则 键 名 会 以 连续 方式 重新 索引 。 


注释 : 如 果 仅 仅 向 array merge() 函数 输入 了 一 个 数组 ， 且 键 名 是 整数 ， 则 该 本 数 将 返回 带 有 
整数 键 名 的 新 数组 ， 其 键 名 以 0 开始 进行 重新 索引 。 (参见 例子 2) 


语法 


array merge(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 输 入 的 第 一 个 数组 。 
array2 必需 。 输 入 的 第 二 个 数组 。 
array3 可 选 。 可 指定 的 多 个 输入 数组 。 


例子 1 


<?php 

$a1=array( "a"=>s"Horse" / "p'z»"pog" ) P 
$a2-ar ray( "c"2>"Cow" 7 yw eats ) ; 
print r(array merge($a1, $a2)); 

?> 


输出 : 


Array ( [a] => Horse [b] => Cat [c] => Cow ) 


例子 2 


仅 使 用 一 个 数组 参数 : 


<?php 

$a=array(3=>"Horse", 4=>"Dog"); 
print r(array merge($a)); 

?> 


输出 : 


Array ( [0] => Horse [1] => Dog ) 


PHP array merge recursive() 函数 


定义 和 用 法 


array merge recursive() BAX array merge() 函数 一 样 ， 将 一 个 或 多 个 数组 的 元 素 的 合并 
起 来 ， 一 个 数组 中 的 值 附 加 在 前 一 个 数组 的 后 面 。 并 返回 作为 结果 的 数组 。 


但 是 ， 与 array merge() 不 同 的 是 ， 当 有 重复 的 键 名 时 ， 值 不 会 被 覆盖 ， 而 是 将 多 个 相同 键 名 
的 值 递归 组 成 一 个 数组 。 (参见 例子 1) 


array merge recursive(arrayl,array2,array3...) 


参数 描述 
array1 必需 。 输 入 的 第 一 个 数组 。 
array2 必需 。 输 入 的 第 二 个 数组 。 
array3 可 选 。 可 指定 的 多 个 输入 数组 。 


提示 和 注释 


注释 : 当 向 array merge recursive() 范 数 仅 仅 输 入 一 个 数组 时 ， 结 果 和 与 array_merge() + 
同 。 


例子 1 


<?php 

$a1=array( "a"2>"Horse" y "b"=>"Dog" ) > 
$a2-ar ray( "c"2>"Cow" ; a ) > 

print r(array merge recursive($a1,$a2)); 
?> 


输出 : 


Array ( 

[a] => Horse 

[b] => Array ( [0] => Dog [1] => Cat ) 
[c] => Cow 


) 
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PHP array multisort() 函数 


M. : 
定义 和 用 法 
array multisort() 函数 对 多 个 数组 或 多 维 数组 进行 排序 。 


参数 中 的 数组 被 当成 一 个 表 的 列 并 以 行 来 进行 排序 - 这 类 似 SQL 的 ORDER BY 子 句 的 功 
能 。 第 一 个 数组 是 要 排序 的 主要 数组 。 数 组 中 的 行 ( 值 ) 比较 为 相同 的 话 ， 就 会 按照 下 一 个 
输入 数组 中 相应 值 的 大 小 进行 排序 ， 依 此 类 推 。 


第 一 个 参数 是 数组 ， 随 后 的 每 一 个 参数 可 能 是 数组 ， 也 可 能 是 下 面 的 排序 顺序 标志 (排序 标 
志 用 于 更 改 默认 的 排列 顺序 ) 之 一 : 


e SORT ASC- 默认 ， 按 升序 排列 。(A-Z) 
e SORT DESC - 按 降序 排列 。(Z-A) 


随后 可 以 指定 排序 的 类 型 : 


e SORT REGULAR - 默认 。 将 每 一 项 按 常 规 顺 序 排 列 。 
e SORT NUMERIC - 将 每 一 项 按 数字 顺序 排列 。 
e SORT STRING - 将 每 一 项 按 字母 顺序 排列 。 


语法 


array multisort(array1,sorting order,sorting type,array2,array3...) 


参数 描述 

array1 必需 。 规 定 输入 的 数组 。 

dias 可 选 。 规 定 排列 顺序 。 可 能 的 值 是 SORT_ASC 和 SORT. DESC. 

sorting 可 选 。 规 定 排序 类 型 。 可 能 的 值 是 SORT_REGULAR、SORT_NUMERIC 和 
type SORT STRING, 

array2 可 选 。 规 定 输入 的 数组 。 

array3 可 选 。 规 定 输入 的 数组 。 

日 二 Na t 
提示 和 注释 


注释 : 字符 串 键 名 将 被 保留 ， 但 是 数字 键 将 被 重新 索引 ， 从 0 开始 ， 并 以 1 递增 。 


注释 : 您 可 以 在 每 个 数组 后 设置 排序 顺序 和 排序 类 型 。 如 果 没 有 设置 ， 每 个 数组 参数 会 使 用 
默认 值 。 


例子 1 


<?php 

$ai1-array("Dog", "Cat"); 
$a2-array("Fido","Missy"); 
array multisort($a1, $a2); 
print r($a1); 

print r($a2); 

?> 


俞 出 : 


Array ( [0] => Cat [1] => Dog ) 
Array ( [0] -» Missy [1] -» Fido ) 


例子 2 
当 两 个 值 相 同时 如 何 排序 : 


<?php 
$al-zarray( "Dog", "Dog", "Cat"); 
$a2-array("Pluto","Fido","Missy"); 
array multisort($a1, $42), 

print r($a1); 

print r($a2); 

?> 


俞 出 : 


Array ( [0] => Cat [1] => Dog [2] => Dog ) 
Array ( [0] -» Missy [1] -» Fido [2] -» Pluto ) 


例子 3 


带 有 排序 参数 : 


<?php 

$a1l=array("Dog"， "Dog", "Cat"); 
$a2-array( "Pluto", "Fido", "Missy"); 

array multisort($a1, SORT ASC, $a2, SORT DESC); 
print r($a1); 

print r($a2); 

?> 


输出 : 


Array ( [0] => Cat [1] => Dog [2] => Dog ) 
Array ( [0] => Missy [1] => Pluto [2] => Fido ) 


PHP array pad() 西数 

定义 和 用 法 

array pad() 函数 向 一 个 数组 插 和 人 带 有 指定 值 的 指定 数量 的 元 素 。 
语法 


array_pad(array, size, value) 


参数 描述 

array 必需 。 规 定数 组 。 

size 必需 。 指 定 的 长 度 。 整 数 则 填补 到 右 侧 ， 负 数 则 填补 到 左 侧 。 
value 必需 。 用 来 填补 的 值 。 


提示 和 注释 
提示 : 如 何 设置 了 负 的 长 度 值 ， 该 函数 会 在 原始 数组 之 前 插入 新 的 元 素 。 (参见 例子 2) 
注释 : 如 果 size 参数 小 于 原始 数组 的 长 度 ， 该 本 数 不 会 删除 任何 元 素 。 


例子 1 


<?php 

$azarray( "Dog", cat. ) 

print r(array pad($a,5,0)): 
2» 


输出 : 


Array ( [0] => Dog [1] => Cat [2] => 0 [3] => 0 [4] => 0 ) 


例子 2 


带 有 负 的 size 参数 : 


<?php 

$a-array("Dog", "Cat"); 

print r(array pad($a, -5,0)); 
?> 


输出 : 


Array ( [0] => © [1] => © [2] => 6 [3] => Dog [4] => Cat ) 


PHP array pop() HŽ 


sh - S 
array pop() ERg2 a BREN a FR B ES — SICH 
语法 


array pop(array) 


参数 


array 必需 。 规 定 输 入 的 数组 参数 。 


例子 


<?php 
$a-array("Dog", "Cat", "Horse"); 
array pop($a); 

print r($a); 

?» 


输出 : 


Array ( [0] => Dog [1] => Cat ) 


PHP array prod 


定义 和 用 法 


array_product() 函数 计算 并 返回 数组 中 所 有 值 的 乘积 。 


语法 


array product(array) 


array 必需 。 规 


例子 


<?php 

$a=array(5,5); 
echo(array_product ($a)); 
?> 


输出 : 


25 


uct() Až 


定 输入 的 数组 参数 。 


PHP array push() 2 


定义 和 用 法 


array push() 函数 向 第 一 个 参数 的 数组 尾部 添加 一 个 或 多 个 元 素 (入 栈 ) ， 然 后 返回 新 数组 
的 长 度 。 


WMS FS RIA $array[] = $value. 
语法 


array push(array, valuei,value2... 


— 


参数 描述 
array 必需 。 规 定 一 个 数组 。 
value1 必需 。 规 定 要 添加 的 值 。 
value2 可 选 。 规 定 要 添加 的 值 。 


提示 和 注释 
注释 : 即使 数组 中 有 字符 串 键 名 ， 您 添加 的 元 素 也 始终 是 数字 键 。 (参见 例子 2) 


注释 : 如 果 用 arraypush() 来 给 数组 增加 一 个 单元 ， 还 不 如 用 $array[] =_ 这 样 没有 调用 
PRA AM fa 1B. 


注释 : 如 果 第 一 个 参数 不 是 数组 ，array_push() 将 发 出 一 条 警告 。 这 和 $var[] 的 行为 不 同 ， 
后 者 会 新 建 一 个 数组 。 


例子 1 


<?php 

$azarray("Dog", "Cat" ) 

array push($a, "Horse", "Bird"); 
print r($a); 

?> 


输出 : 


Array ( [0] -» Dog [1] -» Cat [2] -» Horse [3] -» Bird ) 


例子 2 
带 有 字符 串 键 的 数组 : 


<?php 

$a=array( "a"=>"Dog", pica ) ; 
array push($a, "Horse", "Bird"); 
print r($a); 

?> 


输出 : 


Array ( [a] => Dog [b] => Cat [0] => Horse [1] => Bird ) 


PHP array rand() 2X 


定义 和 用 法 
array rand() 画 数 从 数组 中 随机 选 出 一 个 或 多 个 元 素 ， 并 返回 。 


第 二 个 参数 用 来 确定 要 选 出 几 个 元 素 。 如 果 选 出 的 元 素 不 止 一 个 ， 则 返回 包含 随机 键 名 的 数 
组 ， 否 则 返回 该 元 素 的 键 名 。 


注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() 函数 给 随机 数 发 生 器 播种 ， 现 已 
被 自动 完成 。 


语法 


array rand(array, number ) 


BR 描述 
array 必需 。 规 定 输入 的 数组 参数 。 
number 可 选 。 默 认 是 1。 规 定 返 回 多 少 个 随机 的 元 素 。 


例子 1 


<?php 

$a=array("a"=>"Dog", "b"=>"Cat", "c"=>"Horse"); 
print_r(array_rand($a,1)); 

?> 


输出 : 


b 


例子 2 
带 有 字符 串 键 的 数组 : 


<?php 

$a=array("a"=>"Dog", "b"=>"Cat", "c"=>"Horse"); 
print_r(array_rand($a,2)); 

?> 
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输出 : 


Array ( [0] => c [1] => b ) 


PHP array rand() aX 


T3 


PHP array reduce() E325 


定义 和 用 法 


array reduce() 函数 用 回调 函数 迭代 地 将 数组 简化 为 单一 的 值 。 如 果 指 定 第 三 个 参数 ， 则 该 参 
数 业 被 当成 是 数组 中 的 第 一 个 值 来 人 处理， 或 者 如 果 数 组 为 空 的 话 就 作为 最 终 返 回 值 。 


语法 


array reduce(array, function, initial) 


参数 描述 
array 必需 。 规 定 输入 的 数组 。 
function 必需 。 规 定 自 定义 回调 函数 的 名 称 。 
initial 可 选 。 如 果 规 定 了 该 参数 ， 该 参数 将 作为 数组 中 的 第 一 个 值 来 处 理 。 


例子 1 


<?php 
function myfunction($v1,$v2) 


return $v1 . "-" . $v2; 


$a-array("Dog", "Cat", "Horse"); 
print r(array reduce($a, "myfunction")); 
?> 


输出 : 


-Dog-Cat-Horse 


例子 2 


带 有 initial 参数 : 


<?php 

function myfunction($v1,$v2) 
return $v1 . "-" . $v2; 

} 
$a=array("Dog", "Cat", "Horse"), 


print r(array reduce($a, "myfunction",5)); 
?> 


输出 : 


5-Dog-Cat-Horse 


例子 3 
返回 总 和 : 
<?php 
function myfunction($v1, $v2) 
return $v1+$V2, 
} 
$a=array(10,15, 20); 


print r(array reduce($a, "myfunction",5)); 
?> 


输出 : 


50 


PHP array reverse() HŽ 


定义 和 用 法 


array reverse() 函数 将 原 数组 中 的 元 素 顺 序 翻 转 ， 创 建新 的 数组 并 返回 。 如 果 第 二 个 参数 指 
定 为 ttue， 则 元 素 的 键 名 保持 不 变 ， 否 则 键 名 将 丢失 。 


语法 


array reverse(array, preserve) 


参数 描述 
array 必需 。 规 定数 组 。 


Sees | eS 规定 是 否 保留 原始 数组 的 键 名 。 可 能 的 值 : true 和 false。 这 个 参数 是 
PHP 4.0.3 中 新 加 的 。 


例子 


<?php 

$a=array("a"=>"Dog", "b"=>"Cat", "c"=>"Horse"); 
print r(array reverse($a)); 

?> 


输出 : 


Array ( [c] => Horse [b] => Cat [a] => Dog ) 


PHP array search() 函数 


> : 
array search() HA- in_array) 一 样 ， 在 数组 中 查找 一 个 键 值 。 如 果 找 到 了 该 值 ， 匹 配 元 素 
的 键 名 会 被 返回 。 如 果 没 找到 ， 则 返回 false. 

在 PHP 4.2.0 Za, PAE Amat RE] null 而 不 是 false, 


如 果 第 三 个 参数 strict 被 指定 为 true， 则 只 有 在 数据 类 型 和 值 都 一 致 时 才 返 回 相应 元 素 的 键 
Be 


value ”必需 。 规 定 在 数组 中 搜索 的 值 。 
array ”必需 。 被 搜索 的 数组 。 


可 选 。 可 能 的 值 : true false -默认 如 果 值 设置 为 true， 还 将 在 数组 中 检查 
给 定 值 的 类 型 。 (参见 例子 2) 


例子 1 


<?php 

$a=array("a"=>"Dog", =>uCat 生 "c"=>"Horse"); 
echo array search("Dog", $a), 

?> 


输出 : 


例子 2 


<?php 

$a=array("a"=>"5", Ube M MD ), 
echo array search(5, $a, true), 

?> 


输出 : 


PHP array shift() 函数 


定义 和 用 法 
array shift() 函数 删除 数组 中 的 第 一 个 元 素 ， 并 返回 被 删除 元 素 的 值 。 


注释 : 如 果 键 是 数字 的 ， 所 有 元 素 都 将 获得 新 的 键 ， 从 0 开始 ， 并 以 1 递增 。 (参见 例子 
2) o 


array shift(array) 


参数 描述 
array 必需 。 规 定 输 入 的 数组 。 


例子 1 


<?php 

$a=array("a"=>"Dog", "b"=>"Cat", "c"=>"Horse"); 
echo array shift($a), 

print r ($a), 

?> 


输出 : 


Dog 
Array ( [b] => Cat [c] => Horse ) 


例子 2 
带 有 数字 键 : 


<?php 
$azarray(0->"Dog",1->"Cat",2->"Horse"), 
echo array shift($a), 

print r ($a), 

?> 


输出 : 
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Dog 
Array ( [0] -» Cat [1] -» Horse ) 


PHP array shift() EAižk 
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PHP array slice() 2X 


定义 和 用 法 
array slice() 函数 在 数组 中 根据 条 件 取出 一 段 值 ， 并 返回 。 
注释 : 如 果 数 组 有 字符 串 键 ， 所 返回 的 数组 将 保留 键 名 。 (参见 例子 4) 


语法 


array slice( array , offset , length , preserve ) 





参数 描述 
array 必需 。 规 定 输入 的 数组 。 
offset 必需 。 数 值 。 规 定 取出 元 素 的 开始 位 置 。 如 果 是 正 数 ， 则 从 前 往 后 开始 取 ， 


如 果 是 负 值 ， 从 后 向 前 取 offset 绝对 值 。 


可 选 。 数 值 。 规 定 被 返回 数组 的 长 度 。 如 果 length 为 正 ， 则 返回 该 数量 的 元 
length Ro "SR length 为 负 ， 则 序列 将 终止 在 距离 数组 末端 这 人 么 远 的 地 方 。 如 果 省 
略 ， 则 序列 将 从 offset 开始 直到 array 的 末端 。 


preserve ”可 选 。 可 能 的 值 : true -保留 键 false -默认 - Bee 


例子 1 


<?php 
$azarray(0->"Dog",1->"Cat",2->"Horse", 3->"Bird"), 
print r(array slice($a,1,2)); 

?> 


输出 : 


Array ( [0] => Cat [1] => Horse ) 


例子 2 


带 有 负 的 offset 参数 : 


<?php 
$azarray(0->"Dog",1->"Cat",2->"Horse", 3=>"Bird"); 
print r(array slice($a, -2,1)); 

?> 


输出 : 


Array ( [0] => Horse ) 


例子 3 


preserve 参数 设置 为 true : 


<?php 
$azarray(0->"Dog",1->"Cat",2->"Horse", 3=>"Bird"); 
print r(array slice($a,1,2, true)), 

?> 


输出 : 


Array ( [1] => Cat [2] => Horse ) 


例子 4 
带 有 字符 串 键 : 


<?php 

$a=array("a"=>"Dog", "Du —5 Cato "c"=>"Horse", "q"=>s"Bird" )n 
print r(array slice($a,1,2)); 

?> 


输出 : 


Array ( [b] => Cat [c] => Horse ) 


PHP array splice() 2X 


ch 、 : 

定义 和 用 法 

array splice() 函数 与 array. slice() 函数 类 似 ， 选 择 数 组 中 的 一 系列 元 素 ， 但 不 返回 ， 而 是 删 
除 它们 并 用 其 它 值 代 蔡 。 

如 果 提 供 了 第 四 个 参数 ， 则 之 前 选中 的 那些 元 素 将 被 第 四 个 参数 指定 的 数组 取代 。 

最 后 生成 的 数组 将 会 返回 。 


语法 


array splice(array,offset, length,array) 


参数 描述 
array 必需 。 规 定数 组 。 


必需 。 数 值 。 如 果 offset 为 正 ， 则 从 输入 数组 中 该 值 指定 的 偏 移 量 开始 移 除 。 
如 果 offset 为 负 ， 则 从 输入 数组 末尾 倒数 该 值 指 定 的 偏 移 量 开始 移 除 。 


可 选 。 数 值 。 如 果 省 略 该 参数 ， 则 移 除数 组 中 从 offset 到 结尾 的 所 有 部 分 。 如 
length FRIST length 并 且 为 正 值 ， 则 移 除 这 么 多 元 素 。 如 果 指 定 了 length 且 为 负 
值 ， 则 移 除 从 offset 到 数组 末尾 倒数 length 为 止 中 间 所 有 的 元 素 。 


被 移 除 的 元 素 由 此 数组 中 的 元 素 蔡 代 。 如 果 没有 移 除 任何 值 ， 则 此 数组 中 的 元 


array — 素 将 插入 到 指定 位 置 。 


提示 和 注释 


提示 : 如 果 画 数 没 有 删除 任何 元 素 (length=0)， 则 替代 数组 将 从 start 参数 的 位 置 插入 。 (S 
见 例子 3) 


注释 : 不 保留 替代 数组 中 的 键 。 


例子 1 


<?php 

$al-array(0->"Dog", 1->"Cat",2->"Horse", 3=>"Bird"); 
$a2-array(0->"Tiger",1->"Lion"), 

array splice($a1,90,2,$a2); 

print r($a1); 

?> 


输出 : 


Array ( [0] => Tiger [1] => Lion [2] => Horse [3] => Bird ) 


例子 2 
与 例子 1 相同 ， 但 是 输出 返回 的 数组 : 


<?php 
$alzarray(0->"Dog",1->"Cat",2->"Horse", 3=>"Bird"); 
$a2-array(0-»"Tiger",1-»"Lion"); 

print r(array splice($a1,0,2,$42)), 

?> 


输出 : 


Array ( [0] => Dog [1] => Cat ) 


例子 3 
length 参数 设置 为 0 : 


<?php 

$al-zarray(0->"Dog", 1->"Cat"),: 
$a2-array(0-»"Tiger",1-»"Lion"); 
array splice($a1,1,0,$a2); 

print r($a1); 

?> 


输出 : 


Array ( [0] => Dog [1] => Tiger [2] => Lion [3] => Cat ) 


PHP array sum() HŽ% 


定义 和 用 法 
array sum() 函数 返回 数组 中 所 有 值 的 总 和 。 


如 果 所 有 值 多 是 整数 ， 则 返回 一 个 整数 值 。 如 果 其 中 有 一 个 或 多 个 值 是 浮 点 数 ， 则 返回 浮 点 
数 。 


PHP 4.2.1 之 前 的 版 本 修改 了 传人 的 数组 本 身 ， 将 其 中 的 字符 串 值 转换 成 数值 〈 大 多 数 情况 下 
都 转换 成 了 需 ， 根 据 具体 制 而 定 ) o 


语法 


array_sum(array) 


array 必需 。 规 定 输入 的 数组 。 


例子 


<?php 
$a=array(0=>"5",1=>"15",2=>"25"); 
echo array_sum($a); 

?> 


输出 : 


45 


PHP array udiff() 函数 


= 、 : 
array_udiff() 画 数 返回 一 个 数组 ， 该 数组 包括 了 所 有 在 被 比较 数组 中 ， 但 是 不 在 任何 其 它 参 数 
数组 中 的 值 ， 键 名 保留 不 变 。 

array_udiff() HANS array diff() 函数 的 行为 不 同 ， 后 者 用 内 部 阔 数 进行 比较 。 


数据 的 比较 是 用 arrayudiff() 函数 的 _function 进行 的 。function 函数 带 有 两 个 将 进行 比较 的 参 
数 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 画 数 返回 一 个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返回 
0， 如 果 第 一 个 参数 大 于 第 二 个 ， 则 返回 一 个 正 数 。 





语法 
array udiff( arrayl , array2 , array3 ..., function ) 
参数 描述 
array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function 必需 。 自 定义 的 比较 回调 图 数 。 


注释 : array_udiff() 画 数 仅 检查 多 维 数组 中 的 一 维 。 


例子 


<?php 
function myfunction($v1,$v2) 


1 
if ($v1===$v2) 


return 0; 


J 


return 1, 


} 

$al-array( Wawa (A , "b"=>"Dog" "c"=>"Horse" ) R 
$a2=array(1=>"Cat",2=>"Dog", 3=>"Fish"); 

print r(array udiff($a1, $a2, "myfunction")); 

?> 


输出 : 


Array ( [c] => Horse ) 


PHP array udiff assoc() 函数 


定义 和 用 法 
arrayudiff assoc() 函数 返回 array! 中 存在 但 其 它 数组 中 都 不 存在 的 部 分 。 


注意 与 array_diff() 以 及 array_udiff() 不 同 的 是 键 名 也 用 于 比较 。 同 时 进行 键 名 和 键 值 的 比 
较 。 如 "a"=>1 和 "b"=>1 这 两 个 元 素 是 不 相等 的 。 


数组 数据 的 比较 是 用 用 户 提供 的 回调 函数 进行 的 。 在 此 方面 和 array diff assoc() 的 行为 正好 
相反 ， 后 者 是 用 内 部 本 数 进行 比较 的 。 


arrayudiff assoc() WEY function 参数 指定 的 函数 用 于 比较 元 素 是 否 相 等 。 如 nction HR i 
有 两 个 将 进行 比较 的 参数 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 返回 一 个 负数 ， 如 果 两 
个 参数 相等 ， 则 要 返回 0， 如 果 第 一 个 参数 大 于 第 二 个 ， 则 返回 一 个 正 数 。 


语法 


array udiff assoc(arrayl,array2,array3..., function) 


参数 描述 
array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function Ait, BECHLER ANA, 


例子 


<?php 
function myfunction($v1, $v2) 


t 
if ($vi---$v2) 
t 
return 0; 
return 1; 
$ai=array("a"=>"Cat","b"=>"Dog", "c"=>"Horse"); 


$a2=array("a"=>"Cat","b"=>"Horse", "c"=>"Dog"); 
print r(array udiff assoc($a1,$a2, "myfunction")), 
?> 
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输出 : 


Array ( [b] => Dog [c] => Horse ) 


PHP array udiff assoc() 函数 
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PHP array udiff uassoc() HŽ% 


定义 和 用 法 
arrayudiff uassoc() 函数 返回 _array1 数组 中 存在 但 其 它 数组 中 都 不 存在 的 部 分 。 返 回 的 数组 
中 键 名 保持 不 变 。 


注意 与 array_diff() 以 及 array_udiff() 不 同 的 是 键 名 也 用 于 比较 。 同 时 进行 键 名 和 键 值 的 比 
较 ， 如 "a"=>1 和 "b"=>1 这 两 个 元 素 是 不 相等 的 。 


对 键 名 (索引 ) REBEL] WR function1 进行 的 。 这 和 array udiff assoc() 的 行为 不 
同 ， 后 者 是 用 内 部 汞 数 比 较 索 引 的 。 


数组 数据 的 比较 是 使 用 用 户 提供 的 回调 函数 function2 进行 的 。 在 此 方面 和 array diff assoc() 
的 行为 正好 相反 ， 后 者 是 用 内 部 函数 进行 比较 的 。 


这 两 个 图 数 都 带 有 两 个 将 进行 比较 的 参数 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 返回 一 
个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返回 0， 如 果 第 一 个 参数 大 于 第 二 个 ， 则 返回 一 个 正 数 。 


语法 

array udiff uassoc(arrayl,array2,array3..., function1, function2) 
参数 描述 

array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function1 no tba Anh AE LAR 
function2 必需 。 比 较 值 的 自 定 义 函 数 。 


注释 : function? 指定 的 函数 用 于 比较 键 名 是 否 相 等 。function2 指定 的 函数 用 于 比较 键 值 是 
相等 。 


例子 


<?php 
function myfunction key($v1,$v2) 


{ 
if ($v1===$v2) 


return 0; 


j 


return 1; 


J 


function myfunction value($v1,$v2) 
t 
if ($v1===$v2) 


return 0; 


J 


return 1, 


J 

$ai=array( Walls Gt b "b"=>"Dog" ; "c"=>"Horse" ) ; 

$a2-array( "a"=>"Cat", "b"=>"Dog", "c"->"Ejsh" ) ; 

print r(array udiff uassoc($al, $a2, "myfunction key","myfunction value")); 
?> 


输出 : 


Array ( [c] => Horse ) 


PHP array uintersect() EX2X 
定义 和 用 法 


array uintersect() 函数 计算 数组 的 交集 ， 用 回调 函数 比较 数据 。 


arrayuintersect() 返回 一 个 数组 ， 该 数组 包含 了 所 有 在 _array1 中 也 同时 出 现在 所 有 其 它 参 数 
数组 中 的 值 。 数 据 ( 键 值 ) 比较 是 用 回调 函数 进行 的 。 


语法 
array uintersect(array1,array2,array3..., function) 
参数 描述 
array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function 必需 。 自 定义 函数 的 名 称 。 
说 明 


TAA BES AE ERX function 来 计算 两 个 或 多 个 数组 的 交集 〈 即 在 array? 中 存在 同时 
也 在 其 它 任 何 数组 中 存在 的 所 有 数组 元 素 ) ， 并 返回 结果 数组 。 


只 进行 键 值 的 比较 ， 不 比较 键 名 ， 如 "a"=>1 和 "b"=>1 这 两 个 元 素 视 作 相 等 的 。 


function 参数 指定 的 函数 用 于 比较 元 素 是 否 相 等 。function 辑 数 带 有 两 个 将 进行 比较 的 参数 。 
= 则 画 数 返回 一 个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返回 0， 如 
果 第 一 个 参数 大 于 第 二 则 返回 一 个 正 数 。 


返回 的 数组 中 键 名 保持 不 变 。 


例子 


<?php 
function myfunction($v1, $v2) 


t 
if ($vi---$v2) 
return 0; 
if ($v1 > $v2) return 1; 


return -1; 


} 


return 1; 


} 

$ai=array( Wawa Sl (Et , "b"=>"Dog" y "c"=>"Horse" ) ; 
$a2-array(1-»"Cat",2-»2"Dog",3-»"Fish"); 

print r(array uintersect($a1, $a2, "myfunction")); 
?> 


输出 : 


Array ( [al => Cat [b] => Dog ) 


PHP array uintersect assoc() 函数 


= . i 
定义 和 用 法 
array uintersect assoc() 本 数 带 索 引 检查 计算 数组 的 交集 ， 用 回调 函数 比较 数据 。 


arrayuintersect assoc() 返回 一 个 数组 ， 该 数组 包含 了 所 有 在 _array1 中 也 同时 出 现在 所 有 其 
它 参 数 数组 中 的 值 。 


注意 ， 与 array_uintersect() 不 同 的 是 键 名 也 要 比较。 数据 Gta) 是 用 回调 范 数 比 较 的 。 


语法 

array uintersect assoc(array1,array2,array3..., function) 
参数 描述 

array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function 必需 。 自 定义 函数 的 名 称 。 

说 明 


使 用 用 户 自 定义 的 回调 函数 function 来 计算 两 个 或 多 个 数组 的 交集 (BE array? 中 存在 ， 同 
时 也 在 其 它 任何 数组 中 存在 的 所 有 数组 元 素 ) ， 并 返回 结果 数组 。 


同时 进行 键 名 和 键 值 的 比较 ， 如 "a"=>1 和 "b"=>1 这 两 个 元 素 是 不 相等 的 。 


function 参数 指定 的 函数 用 于 上 比较 元 素 是 否 相 等 。function HR A TRE SET Eb ELS CS 
如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 返回 一 个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返回 0， 如 
果 第 一 个 参数 大 于 第 二 个 ， 则 返回 一 个 正 数 。 


返回 的 数组 中 键 名 保持 不 变 。 


例子 


<?php 
function myfunction($v1,$v2) 


1 
if ($v1===$v2) 


return 0; 


J 


return 1, 


} 

$ai=array( WAS Soll ea tel ; "b"=>"Dog" , "c"=>"Horse" ) 7 
$a2-array( awe 7 "p'-2"Horse" ; "c"2>"Dog" ) 

print r(array uintersect assoc($a1, $a2, "myfunction")); 
?> 


输出 : 


Array ( [al => Cat ) 


PHP array uintersect uassoc() 函数 


= > i 
array uintersect uassoc WM # 589145 Ai RRUAR, ALAWAR PIRA RZ. 


arrayuintersect uassoc() 返回 一 个 数组 ， 该 数组 包含 了 所 有 在 array 中 也 同时 出 现在 所 有 
其 它 参 数 数组 中 的 值 。 


注意 ， 与 array_uintersect() 不 同 的 是 键 名 也 要 上 比较 。 键 值 和 键 名 (索引) BEH] AWA 
较 的 。 


语法 
array uintersect uassoc(array1,array2,array3...,functioni, function2) 
参数 描述 
array1 必需 。 被 比较 的 数组 。 
array2 必需 。 用 来 做 比较 的 数组 。 
array3 可 选 。 用 来 做 比较 的 数组 ， 可 有 多 个 。 
function1 必需 。 上 比较 键 名 的 自 定义 函数 。 
function2 Wis. bose BJ JE S AŽ. 
说 明 


使 用 用 户 自 定义 的 回调 画 数 function1 和 function2 来 计算 两 个 或 多 个 数组 的 交集 (HE 
array1 中 存在 ， 同 时 也 在 其 它 任何 数组 中 存在 的 所 有 数组 元 素 ) ， 并 返回 结果 数组 。 


同时 进行 键 名 和 键 值 的 比较 ， 如 "a"=>1 和 "b"=>1 这 两 个 元 素 是 不 相等 的 。 


function? 指定 的 范 数 用 于 比较 键 名 是 否 相 等 。function2 指定 的 函数 用 于 比较 键 值 是 否 相等 。 
这 两 个 图 数 都 带 有 两 个 将 进行 比较 的 参数 。 如 果 第 一 个 参数 小 于 第 二 个 参数 ， 则 函数 返回 一 
个 负数 ， 如 果 两 个 参数 相等 ， 则 要 返回 0， 如 果 第 一 个 参数 大 于 第 二 个 ， 则 返回 一 个 正 数 。 


返回 的 数组 中 键 名 保持 不 变 。 


例子 


<?php 
function myfunction key($v1,$v2) 


{ 
if ($v1===$v2) 


return 0; 


} 


return 1; 


} 


function myfunction value($v1, $v2) 
{ 
if ($v1===$v2) 


return 0, 


J 


return 1, 


J 

$al-array( Iur — I cat ; "b"=>"Dog" , "c"=>"Horse" ) ; 

$a2-array( Walls ap A "b"=>"Dog" A "c"=>"Dog" ) ; 

print r(array uintersect uassoc($a1, $a2, "myfunction key", "myfunction value")); 
?> 


输出 : 


Array ( [al => Cat [b] => Dog ) 


+ 


PHP array unique() E325 


A 


定义 和 用 法 
array unique() 函数 移 除 数组 中 的 重复 的 值 ， 并 返回 结果 数组 。 
当 几 个 数组 元 素 的 值 相 等 时 ， 只 保留 第 一 个 元 素 ， 其 他 的 元 素 被 删除 。 


返回 的 数组 中 键 名 不 变 。 
语法 


array_unique(array) 


参数 描述 
array 必需 。 规 定 输入 的 数组 。 
说 明 
arrayunique() 先 将 值 作为 字符 串 排 序 ， 然 后 对 每 个 值 只 保留 第 一 个 遇 到 的 键 名 ， 接 着 忽略 所 


有 后 面 的 键 名 。 这 并 不 意味 着 在 未 排序 的 _array 中 同一 个 值 的 第 一 个 出 现 的 键 名 会 被 保留 。 


提示 和 注释 


注释 : 被 返回 的 数组 将 保持 第 一 个 数组 元 素 的 键 类 型 。 


例子 


<?php 

$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Cat"); 
print_r(array_unique($a)); 

?> 


输出 : 


Array ( [a] => Cat [b] => Dog ) 


PHP array unshift() 函数 


定义 和 用 法 

array_unshift() 函数 在 数组 开头 插入 一 个 或 多 个 元 素 。 

被 加 上 的 元 素 作 为 一 个 整体 添加 ， 这 些 元 素 在 数组 中 的 顺序 和 在 参数 中 的 顺序 一 样 。 
该 图 数 会 返回 数组 中 元 素 的 个 数 。 


语法 


array unshift(array, value1, value2, value3...) 





BR 描述 
array 必需 。 规 定 输入 的 数组 。 
value1 必需 。 规 定 插入 的 值 。 
value2 可 选 。 规 定 插入 的 值 。 
value3 可 选 。 规 定 插入 的 值 。 
提示 和 注释 


注释 : 所 有 的 数值 键 名 将 修改 为 从 需 开 始 重新 计数 ， 所 有 的 字符 串 键 名 保持 不 变 。 


例子 1 


<?php 

$a=array( "a"=>"Cat", "b"=>"Dog" ) : 
array unshift($a, "Horse"), 

print r($a); 

?> 


输出 : 


Array ( [0] => Horse [a] => Cat [b] => Dog ) 


例子 2 


返回 键 值 : 


<?php 

$a=array( "a"=>"Cat", "b"=>"Dog" ) ; 
print r(array unshift($a, "Horse")), 
?> 


俞 出 : 


例子 3 
Bun qus Bust : 


«?php 
$a-array(0-»"Cat",1-»"Dog"); 
array unshift($a, "Horse"); 
print r($a); 

?> 


输出 : 


Array ( [0] => Horse [1] => Cat [2] => Dog ) 


PHP array values() 2% 

定义 和 用 法 

array values() 本 数 返回 一 个 包含 给 定数 组 中 所 有 键 值 的 数组 ， 但 不 保留 键 名 。 
语法 


array values(array) 


array 必需 。 规 定 给 定 的 数组 。 


提示 和 注释 


提示 : 被 返回 的 数组 将 使 用 数值 键 ， 从 0 开始 且 以 1 递增 。 


例子 


<?php 

$a=array("a"=>"Cat", "b"=>"Dog", "c"=>"Horse"); 
print r(array values($a)); 

?> 


输出 : 


Array ( [0] => Cat [1] => Dog [2] => Horse ) 


PHP array walk() 2X 


定义 和 用 法 
array walk() 本 数 对 数组 中 的 每 个 元 素 应 用 回调 函数 。 如 果 成 功 则 返回 TRUE， 否则 返回 
FALSE。 


典型 情况 下 function 接受 两 个 参数 。array 参数 的 值 作为 第 一 个 ， 键 名 作为 第 二 个 。 如 果 提 供 
了 可 选 参数 userdata ， 将 被 作为 第 三 个 参数 传递 给 回调 图 数 。 


如 果 function 画 数 需要 的 参数 比 给 出 的 多 ， 则 每 次 arraywalk() 调用 function 时 都 会 产生 一 
^ E WARNING 级 的 错误 。 这 些 警 告 可 以 通过 在 array walk() 调用 前 加 上 PHP 的 错误 操作 
符 © 来 抑制 ， 或 者 用 error_reporting(). 


语法 


array walk(array, function, userdata...) 


参数 描述 
array 必需 。 规 定数 组 。 
function 必需 。 用 户 自 定义 函数 的 名 称 。 
Userdata 可 选 。 用 户 输入 的 值 ， 可 作为 回调 函数 的 参数 。 
提示 和 注释 


提示 : 您 可 以 为 函数 设置 一 个 或 多 个 参数 。 


注释 : 如 果 回 调 函 数 需要 直接 作用 于 数组 中 的 值 ， 可 以 将 回调 函数 的 第 一 个 参数 指定 为 引 
用 : &$value。 (参见 例子 3) 


注释 : 将 键 名 和 userdata 传递 到 function 中 是 PHP 4.0 新 增加 的 。 


例子 1 


<?php 
function myfunction($value, $key) 


echo "The key $key has the value $value<br />", 
} 


$a-array("a"z»"Cat", "p"z»"pog", "c"=>"Horse"); 
array walk($a, "myfunction"); 
?> 


输出 : 


The key a has the value Cat 
The key b has the value Dog 
The key c has the value Horse 


例子 2 
带 有 一 个 参数 : 


<?php 
function myfunction($value, $key, $p) 


{ 
echo "$key $p $value<br />"; 
J 


$azarray("a"->"Cat","b"->"Dog", "c" ->"Horse"), 
array walk($a, "myfunction", "has the value"), 
?> 


输出 : 


a has the value Cat 
b has the value Dog 
c has the value Horse 


例子 3 


改变 数组 元 素 的 值 (请 注意 &$value) 


<?php 

function myfunction(&$value, $key) 
{ 

$value-"Bird; 

} 


$a-array("a"z»"Cat", "p"z»"pog", "c"=>"Horse"); 
array walk($a, "myfunction"); 

print r($a); 

?> 


输出 : 
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Array ( [a] -» Bird [b] -» Bird [c] -» Bird ) 


PHP array walk() 函数 104 


PHP array walk recursive() 西数 


定义 和 用 法 


与 array walk() Wt 类 似 ，array_walk_recursive() Matta FR BA EA 765 Awe. 
PRE, RRA ARAT REER, AL HM A HLA, Been, Bs 
到 更 深层 的 数组 中 去 。 


eid function 接受 两 个 参数 。array 参数 的 值 作为 第 一 个 ， 键 名 作为 第 二 个 。 如 果 提 
供 了 可 选 参数 userdata ， 将 被 作为 第 三 个 参数 传递 给 回调 函数 。 


如 果 回 调 男 数 需要 直接 作用 于 数组 中 的 值 ， 可 以 将 回调 函数 的 第 一 个 参数 指定 为 引用 ， 这 样 
对 这 些 单元 的 任何 改变 也 将 会 改变 原始 数组 本 身 。 


语法 


array walk recursive(array, function, userdata) 


参数 描述 
array 必需 。 规 定数 组 。 
function 必需 。 用 户 自 定 义 函 数 的 名 称 。 
userdata 可 选 。 用 户 输入 的 值 ， 可 作为 回调 函数 的 参数 。 


例子 


<?php 
function myfunction($value, $key) 


{ 

echo "The key $key has the value $value<br />", 
J 

$ai=array( A ed 7 "b"=>"Dog" ) P 
$a2-array($a41, "1"-»"Bird", "2"-2"Horse"); 

array walk recursive($a2, myfunction"); 

?> 


输出 : 


The key a has the value Cat 
The key b has the value Dog 
The key 1 has the value Bird 
The key 2 has the value Horse 
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PHP arsort() 2X 


定义 和 用 法 

arsort() 画 数 对 数组 进行 逆向 排序 并 保持 索引 关系 。 主 要 用 于 对 那些 单元 顺序 很 重要 的 结合 数 
组 进行 排序 。 

可 选 的 第 二 个 参数 包含 了 附加 的 排序 标识 。 


如 果 成 功 则 返回 TRUE， 和 否则 返回 FALSE. 
语法 


arsort(array, sorttype) 


参数 描述 
array 必需 。 输 入 的 数组 。 
可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 


sorttype ”来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC - 把 值 作为 数字 来 处 理 
SORT LOCALE STRING - 把 值 作为 字符 串 来 人 处理， 基于 本 地 设置 *。 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 在 PHP 6 之 前 ， 使 用 了 系统 的 区 域 设置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc set default() EHX. 


例子 


<?php 
$my_array 二 array("a" => "Dog", IUE => "cat M => "Horse"); 
arsort($my array); 


print r($my array); 
?> 


PHP asort() HA 


定义 和 用 法 

asort() 函数 对 数组 进行 排序 并 保持 索引 关系 。 主 要 用 于 对 那些 单元 顺序 很 重要 的 结合 数组 进 
行 排序 。 

可 选 的 第 二 个 参数 包含 了 附加 的 排序 标识 。 


如 果 成 功 则 返回 TRUE， 否则 返回 FALSE, 
语法 


asort(array, sorttype) 


参数 描述 
array 必需 。 输 入 的 数组 。 


可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 
来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC - 把 值 作为 数字 来 义理 
SORT. STRING - 把 值 作为 字符 串 来 处 理 SORT LOCALE STRING - 把 值 作为 字符 串 
来 处 理 ， 基 于 本 地 设置 


sorttype 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 TE PHP 6 之 前 ， 使 用 了 系统 的 区 域 设 置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc_set_default() 函数 。 


例子 


<?php 
$my_array = array("a" => "Dog", "EM => "Cat", went => "Horse"); 


asort($my array); 
print r($my array); 
?> 


PHP compact() E32 


定义 和 用 法 


compact() 函数 创建 一 个 由 参数 所 带 变 量 组 成 的 数组 。 如 果 参 数 中 存在 数组 ， 该 数组 中 变量 的 


值 也 会 被 获取 。 
本 画 数 返回 的 数组 是 一 个 关联 数组 ， 键 名 为 画 数 的 参数 ， 键 值 为 参数 中 变量 的 值 。 
本 函数 执行 的 行为 与 extract() 正好 相反 。 


语法 


compact(vari,var2...) 


BR 描述 
var1 必需 。 可 以 是 带 有 变量 名 的 字符 串 ， 或 者 是 一 个 变量 数组 。 


Var2 ë 可 选 。 可 以 是 带 有 变量 名 的 字符 串 ， 或 者 是 一 个 变量 数组 。 允 许多 个 参数 。 


注释 和 提示 


注释 : 任何 没有 变量 名 与 之 对 应 的 字符 串 都 被 略 过 。 


例子 1 


<?php 

$firstname = "Peter", 

$lastname = "Griffin", 

$age = "38! i 

$result = compact("firstname", "lastname", "age"); 


print_r($result); 
?> 


输出 : 


Array 


[firstname] -» Peter 
[lastname] => Griffin 
[age] => 38 


例子 2 


使 用 没有 对 应 变量 名 的 字符 串 ， 以 及 一 个 变量 名 数组 : 


<?php 

$firstname = "Peter", 
$lastname = "Griffin"; 
$age = "38", 


$name = array("firstname", "lastname"), 
$result = compact($name, "location", "age"); 


print_r($result); 
?> 


输出 : 


Array 

( 

[firstname] -» Peter 
[lastname] => Griffin 
[age] => 38 

) 


PHP count() 函数 


定义 和 用 法 
count() 范 数 计算 数组 中 的 单元 数目 或 对 象 中 的 属性 个 数 。 


对 于 数组 ， 返 回 其 元 素 的 个 数 ， 对 于 其 他 值 ， 返 回 1。 如 果 参 数 是 变量 而 变量 没有 定义 ， 则 返 
E] 0。 如 果 mode 被 设置 为 COUNT_RECURSIVE (或 1) ， 则 会 递归 诡计 算 多 维 数 组 中 的 
数组 的 元 素 个 数 。 


参数 描述 
array ”必需 。 规 定 要 计数 的 数组 或 对 象 。 


AE 可 选 。 规 定 函 数 的 模式 。 可 能 的 值 : o -默认 。 不 检测 多 维 数 组 (数组 中 的 数 
组 ) 。 1 -检测 多 维 数组 。 注 释 : 该 参数 是 PHP 4.2 中 加 入 的 。 


提示 和 注释 


注释 : 当 变 量 未 被 设置 ， 或 是 变量 包含 一 个 空 的 数组 ， 该 回 数 会 返回 0。 可 使 用 isset() 变量 
来 测试 变量 是 否 被 设置 。 


例子 


<?php 
$people = array("Peter", "Joe", "Glenn", "Cleveland"); 
$result = count($people), 


echo $result; 
?» 


输出 : 


PHP current() E32X 


定义 和 用 法 
current() 画 数 返 回 数组 中 的 当前 元 素 (单元 ) 。 
每 个 数组 中 都 有 一 个 内 部 的 指针 指向 它 “ 当 前 的 元素， 初始 指向 插入 到 数组 中 的 第 一 个 元 素 。 


current() 函数 返回 当前 被 内 部 指针 指向 的 数组 元 素 的 值 ， 并 不 移动 指针 。 如 果 内 部 指针 指向 
超出 了 单元 列表 的 末端 ，current() 返回 FALSE. 


语法 
current(array) 
BR 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


提示 和 注释 
注释 : 如 果 有 空 的 元 素 ， 或 元 素 没 有 值 ， 该 函数 也 返回 FALSE. 


提示 : 该 汞 数 不 会 移动 内 部 指针 。 要 做 到 这 一 点 ， 请 使 用 next() 和 prev() WR, 


例子 


<?php 
$people = array("Peter", "Joe", "Glenn", "Cleveland"); 
echo current($people) . "<br />"; 
?> 
输出 : 


Peter 


PHP each() KŻ 


定义 和 用 法 
each() 男 数 生成 一 个 由 数组 当前 内 部 指针 所 指向 的 元 素 的 键 名 和 键 值 组 成 的 数组 ， 并 把 内 部 
指针 向 前 移动 。 


返回 的 数组 中 包括 的 四 个 元 素 : 键 名 为 0，1，key 和 value。 单 元 0 和 key 包含 有 数组 单元 
的 键 名 ，1 value 包含 有 数据 。 


如 果 内 部 指针 越过 了 数组 范围 ， 本 画 数 将 返回 FALSE, 


语法 
each(array) 
参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


例子 1 


<?php 

$people = array("Peter", "Joe", "Glenn", "Cleveland"), 
print r (each($people)), 

?> 


输出 : 


Array ( [1] => Peter [value] => Peter [0] => 0 [key] => 0 ) 


例子 2 


each() 经 常 和 list() 25 6 f FH 3o ŇA. SISERA, PRAK TEPNA : 


<?php 
$people - array("Peter", "Joe", "Glenn", "Cleveland"), 


reset($people), 
while (list($key, $val) - each($people)) 


echo "$key => $val<br />"; 
J 


?> 


=> Peter 

Joe 

=> Glenn 

=> Cleveland 


UNEO 
II 
V 


例子 解释 


因为 将 一 个 数组 赋值 给 另 一 个 数组 时 会 重 置 原来 的 数组 指针 ， 因 此 在 上 例 中 如 果 我 们 在 循环 
内 部 将 $people 赋 给 了 另 一 个 变量 的 话 将 会 导致 无 限 循环 。 


PHP extract() 2X 


ra. 1 
PHP extract() 函数 从 数组 中 把 变量 导 和 人 到 当前 的 符号 表 中 。 
对 于 数组 中 的 每 个 元 素 ， 键 名 用 于 变量 名 ， 键 值 用 于 变量 值 。 


第 二 个 参数 type 用 于 指定 当 某 个 变量 已 经 存在 ， 而 数组 中 又 有 同名 元 素 时 ，extract() HAM 
何 对 待 这 样 的 冲突 。 


本 本 数 返回 成 功 设置 的 变量 数目 。 
语法 


extract(array,extract rules,prefix) 


参数 描述 
array 必需 。 规 定 要 使 用 的 输入 。 


可 选 。extract() 函数 将 检查 每 个 键 名 是 否 为 合法 的 变量 名 ， 同 时 也 检查 
和 符号 表 中 的 变量 名 是 否 冲 突 。 对 非法 、 数 字 和 冲突 的 键 名 的 义理 将 根 
据 此 参数 决定 。 可 以 是 以 下 值 之 一 : 可 能 的 值 : EXTR OVERWRITE - 
HA. WREE, MERCAN., EXTR_SKIP - 如 果 有 冲突 ， 不 
履 盖 已 有 的 变量 。 (忽略 数组 中 同名 的 元 素 ) ExTR PREFIX sAME - 如 果 
有 冲突 ， 在 变量 名 前 加 上 前 级 prefix, A PHP 4.0.5 起 ， 这 也 包括 了 对 
数字 索引 的 处 理 。 EXTR PREFIX ALL - 给 所 有 变量 名 加 上 前 级 prefix (第 
三 个 参数 ) 。 EXTR PREFIX INVALID - 仅 在 非法 或 数字 变量 名 前 加 上 前 级 
prefix。 本 标记 是 PHP 4.0.5 新 加 的 。 ExTR_IF_EXISTS - 仅 在 当前 符号 表 
中 已 有 同名 变量 时 ， 履 盖 它 们 的 值 。 其 它 的 都 不 处 理 。 可 以 用 在 已 经 定 
义 了 一 组 合法 的 变量 ， 然 后 要 从 一 个 数组 例如 $_REQUEST 中 提取 值 履 
盖 这 些 变量 的 场合 。 本 标记 是 PHP 4.2.0 新 加 

的 。 EXTR_PREFIX_IF_EXISTS - 仅 在 当前 符号 表 中 已 有 同名 变量 时 ， 建 立 
附加 了 前 级 的 变量 名 ， 其 它 的 都 不 义理 。 本 标记 是 PHP 4.2.0 新 加 

的 。 EXTRREFS - 将 变量 作为 引用 提取 。 这 有 力 地 表明 了 导入 的 变量 仍 
然 引 用 了 var array 参数 的 值 。 可 以 单独 使 用 这 个 标志 或 者 在 

extract type 中 用 OR 与 其 它 任 何 标志 结合 使 用 。 本 标记 是 PHP 4.3.0 
新 加 的 。 


可 选 。 请 注意 prefix 仅 在 extract type 的 值 是 
EXTR_PREFIX_SAME ， EXTR_PREFIX_ALL , EXTR_PREFIX_INVALID 或 

prefix EXTR PREFIX IF EXISTS 时 需要 。 如 果 附 加 了 前 级 后 的 结果 不 是 合法 的 变 
量 名 ， 将 不 会 导入 到 符号 表 中 。 前 级 和 数组 键 名 之 间 会 自动 加 上 一 个 下 
Xl A. 


extract rules 


例子 1 


<?php 

$a = "Original", 

$my array = array("a" => "Gat wp" => "Dog", TOU => "Horse"); 
extract($my_array); 

echo "\$a = $a; \$b = $b; \$c = $c"; 

?» 


$a = Cat, $b = Dog; $c = Horse 


例子 2 
使 用 全 部 参数 : 


<?php 
$a = "Original", 
$my array = array("a" => "Cat", "b" => "Dog", "nM —> "Horse"); 


extract($my array, EXTR PREFIX SAME, 'dup'); 


echo "$a = $a; \$b = $b; \$c = $c; N$dup a = $dup a,", 
?» 


$a - Original; $b - Dog; $c - Horse; $dup a - Cat; 


PHP in array() ES2X 


定义 和 用 法 
in array() 函数 在 数组 中 搜索 给 定 的 值 。 
语法 


in array(value,array, type) 


参数 描述 
value ”必需 。 规 定 要 在 数组 搜索 的 值 。 

array ”必需 。 规 定 要 搜索 的 数组 。 

type 可 选 。 如 果 设 置 该 参数 为 trtue， 则 检查 搜索 的 数据 与 数组 的 值 的 类 型 是 否 相 同 。 
说 明 

如 果 给 定 的 值 value 存在 于 数组 array 中 则 返回 true。 如 果 第 三 个 参数 设置 为 true， 辑 数 只 有 
在 元 素 存在 于 数组 中 且 数 据 类 型 与 给 定 值 相同 时 才 返 回 true. 

如 果 没 有 在 数组 中 找到 参数 ， 画 数 返回 false, 

注释 : MR value 参数 是 字符 串 ， 且 type 参数 设置 为 trtue， 则 搜索 区 分 大 小 写 。 


例子 1 


<?php 
$people = array("Peter", "Joe", "Glenn", "Cleveland"), 


if (in array("Glenn", $people)) 
echo "Match found"; 

else 
echo "Match not found"; 


?> 


输出 : 


Match found 


例子 2 


<?php 
$people - array("Peter", "Joe", "Glenn", 


if (in array("23", $people, TRUE)) 


echo "Match found«br /»"; 


J 


else 


echo "Match not found<br />"; 
+if (in array("Glenn",$people, TRUE)) 
{ 


echo "Match found<br /»"; 


} 


else 


echo "Match not found«br />"; 
}if (in array(23,$people, TRUE)) 
t 


echo "Match found<br />"; 


} 


else 


echo "Match not found<br />"; 


} 


?> 


输出 : 


Match not found 
Match found 
Match found 


"Cleveland", 23), 


PHP key() EZ 


= 、 : 
key() 范 数 返回 数组 内 部 指针 当前 指向 元 素 的 键 名 。 
若 失 败 ， 则 返回 FALSE, 


该 函数 与 current() 类 似 ， 只 是 返回 的 结果 不 同 。current() KOROR ETRA, m key() 
函数 返回 的 是 元 素 的 键 名 。 


语法 
key(array) 
参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


例子 


<?php 
$people = array("Peter", "Joe", "Glenn", "Cleveland"); 
echo "The key from the current position is: " . key($people), 
?> 
输出 : 


The key from the current position is: 0 


PHP krsort() EX 


定义 和 用 法 
krsort() 函数 将 数组 按照 键 逆 向 排序 ， 为 数组 值 保 留 原 来 的 键 。 
可 选 的 第 二 个 参数 包含 附加 的 排序 标志 。 


若 成 功 ， 则 返回 TRUE， 否 则 返回 FALSE, 
语法 


krsort(array, sorttype) 


参数 描述 
array 必需 。 规 定 要 排序 的 数组 。 


可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 
来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC - 把 值 作为 数字 来 义理 
SORT. STRING - 把 值 作 为 字符 串 来 处理 SORT LOCALE STRING - 把 值 作 为 字符 串 
来 处理 ， 基 于 本 地 设置 *。 


sorttype 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 在 PHP 6 之 前 ， 使 用 了 系统 的 区 域 设置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc_set_default() ERX. 


例子 


<?php 

$my_array 二 array("a" => "Dog", tAn => "Cat", Wen => "Horse"); 
krsort($my array); 

print r($my array); 

?> 


PHP ksort() 函数 


定义 和 用 法 
ksort() 函数 按照 键 名 对 数组 排序 ， 为 数组 值 保留 原来 的 键 。 
可 选 的 第 二 个 参数 包含 附加 的 排序 标志 。 


若 成 功 ， 则 返回 TRUE， 否 则 返回 FALSE, 
语法 


ksort(array, sorttype) 


参数 描述 
array 必需 。 规 定 要 排序 的 数组 。 


可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 
来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC - 把 值 作为 数字 来 义理 
SORT. STRING - 把 值 作 为 字符 串 来 处理 SORT LOCALE STRING - 把 值 作 为 字符 串 
来 处理 ， 基 于 本 地 设置 *。 


sorttype 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 在 PHP 6 之 前 ， 使 用 了 系统 的 区 域 设置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc_set_default() ERX. 


例子 


<?php 

$my_array 二 array("a" => "Dog", tAn => "Cat", Wen => "Horse"); 
ksort($my array); 

print r($my array); 

?> 


[c] => Horse 


PHP list() KŻ 


定义 和 用 法 
list() 函数 用 数组 中 的 元 素 为 一 组 变量 赋值 。 


注意 ， 与 array() kW, list) 实际 上 是 一 种 语言 结构 ， 不 是 画 数 。 
语法 


list(vari,var2...) 


var1 Wm 


需 
var2 可 选 。 可 以 有 多 个 变量 。 


提示 和 注释 


注释 : 该 图 数 只 用 于 数字 索引 的 数组 ， 且 假定 数字 索引 从 0 开始 。 


例子 1 


<?php 
$my array = array("Dog", "Cat", "Horse"); 


list($a, $b, $c) - $my array; 
echo "I have several animals, a $a, a $b and a $c."; 
?» 


I have several animals, a Dog, a Cat and a Horse. 


例子 2 


<?php 
$my array = array("Dog", "Cat", "Horse"); 


list($a, , $c) - $my array; 
echo "Here I only use the $a and $c variables."; 
?» 


输出 : 


Here I only use the Dog and Horse variables. 


PHP natcasesort() EZX 


定义 和 用 法 


natcasesort() 函数 用 不 区 分 大 小 写 的 自然 顺序 算法 对 给 定数 组 中 的 元 素 排序 。 
natcasesort() 函数 实现 了 “自然 排序 ”” 即 数字 从 1 到 9 的 排序 方法 ， 字 母 从 a 到 z 的 排序 方 


法 ， 短 者 优先 ， 该 图 数 不 区 分 大 小 写 。 数 组 的 索引 与 单元 值 保持 关联 。 


如 果 成 功 ， 则 该 函数 返回 TRUE， 否则 返回 FALSE. 


语法 
natcasesort(array) 
参数 描述 
array 必需 。 规 定 要 进行 排序 的 数组 。 


提示 和 注释 


提示 : natcasesort() 是 natsort() 函数 的 不 区 分 大 小 写字 母 的 版 本 。 


例子 


<?php 
$temp files = array("temp15.txt", "Temp10.txt", 
"temp1.txt", "Temp22.txt", "temp2.txt"); 


natsort($temp files), 
echo "Natural order: ", 
print r($temp files); 
echo "<br /»"; 


natcasesort($temp files); 

echo "Natural order case insensitve: "; 
print r($temp files); 

?> 


输出 : 


Natural order: 
Array 

( 

[0] => Temp10.txt 
[1] => Temp22.txt 
[2] => temp1.txt 
[4] => temp2.txt 
[3] => temp15.txt 
) 


Natural order case insensitve: 
Array 

( 

[2] => temp1.txt 

[4] => temp2.txt 

[0] => Temp10.txt 

[3] => temp15.txt 

[1] => Temp22.txt 

) 


PHP natsort() KŻ 


定义 和 用 法 
natsort() 函数 用 自然 顺序 算法 对 给 定数 组 中 的 元 素 排 序 。 


natsort() 函数 实现 了 "自然 排序 ”， 即 数字 从 1 到 9 的 排序 方法 ， 字 母 从 a F z 的 排序 方法 ， 
短 者 优先 。 数 组 的 索引 与 单元 值 保持 关联 。 


Es] 


Es] 


PRAIA, MARŽE TRUE, S] RIE] FALSE. 


语法 
natsort(array) 
参数 描述 
array 必需 。 规 定 要 进行 排序 的 数组 。 


例子 


本 辑 数 所 用 的 自然 排序 算法 ， 与 通常 的 计算 机 字符 串 排序 算法 (用 于 sort()) 的 区 别 ， 见 下 面 
示例 : 


<?php 
$temp files = array("temp15.txt", "temp10.txt", 
"temp1.txt", "temp22.txt", "temp2.txt"); 


sort($temp files), 

echo "Standard sorting: " 
print r($temp files), 
echo "<br /»"; 


natsort($temp files); 
echo "Natural order: " 
print r($temp files), 
?> 


输出 : 


Standard sorting: Array 
( 

[0] => temp1.txt 

[1] => temp10.txt 

[2] => temp15.txt 

[3] => temp2.txt 

[4] => temp22.txt 

) 


Natural order: Array 
( 

[0] => temp1.txt 

[3] => temp2.txt 

[1] => temp10.txt 
[2] => temp15.txt 
[4] => temp22.txt 

) 


PHP next() HŽ% 


定义 和 用 法 
next() 函数 把 指向 当前 元 素 的 指针 移动 到 下 一 个 元 素 的 位 置 ， 并 返回 当前 元 素 的 值 。 
如 果 内 部 指针 已 经 超过 数组 的 最 后 一 个 元 素 ， 画 数 返 回 false, 


语法 
next(array) 
参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 
说 明 


next() 和 current() 的 行为 类 似 ， 只 有 一 点 区 别 ， 在 返回 值 之 前 将 内 部 指针 向 前 移动 一 位 。 这 
意味 着 它 返 回 的 是 下 一 个 数组 单元 的 值 并 将 数组 指针 向 前 移动 了 一 位 。 如 果 移 动 指针 的 结果 
超出 了 数组 单元 的 末端 ， 则 next() 返回 FALSE, 


注意 : 如 果 数 组 包含 空 的 单元 ， 或 者 单元 的 值 是 0 则 该 图 数 碰 到 这 些 单元 也 返回 FALSE. Z 
正确 台历 可 能 含有 空 单 元 或 者 单元 值 为 0 的 数组 ， 请 参见 each() 函数 。 


例子 


<?php 
$people - array("Peter", "Joe", "Glenn", "Cleveland"), 


echo current($people) . "<br />"; 


echo next ($people), 
?> 


输出 : 


Peter 
Joe 


PHP pos() 函数 


定义 和 用 法 


pos() 函数 是 current() 函数 的 别名 。 它 可 返回 数组 中 当前 元 素 的 值 。 


语法 
pos(array) 
参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


例子 


<?php 

$people = array("Peter", "Joe", "Glenn", "Cleveland"); 
echo pos($people) . "<br /»"; 

?> 


输出 : 


Peter 


PHP prev() 函数 


= 、 : 
prev() 函数 把 据 向 当前 元 素 的 指针 移动 到 上 一 个 元 素 的 位 置 ， 并 返回 当前 元 素 的 值 。 
如 果 内 部 指针 已 经 超过 数组 的 第 一 个 元 素 之 前 ， 画 数 返 回 false. 


语法 


prev( array ) 


参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


说 明 
prev() 和 next() 的 行为 类 似 ， 不 过 它 将 内 部 指针 倒 回 一 位 而 不 是 前 移 一 位 。 


注意 : 如 果 数 组 包含 空 的 单元 ， 或 者 单元 的 值 是 0 则 该 图 数 碰 到 这 些 单元 也 返回 FALSE。 要 
正确 台历 可 能 含有 空 单 元 或 者 单元 值 为 0 的 数组 ， 请 参见 each() 函数 。 


例子 


<?php 
$people - array("Peter", "Joe", "Glenn", "Cleveland"), 


echo current($people) . "<br />", 
echo next($people) . "<br />", 
echo prev($people), 

?> 


输出 : 


Peter 
Joe 
Peter 


PHP range() 函数 

定义 和 用 法 

range() 郴 数 创建 并 返回 一 个 包含 指定 范围 的 元 素 的 数组 。 
语法 


range(first, second, step) 


BR 描述 
first 必需 。 规 定数 组 元 素 的 最 小 值 。 
second ”必需 。 规 定数 组 元 素 的 最 大 值 。 
ep 可 选 。 规 定 元 素 之 间 的 步 进 制 。 默 认 是 d. ER: 该 参数 是 PHP 5 中 加 入 
的 。 
说 明 


该 贺 数 创建 一 个 数组 ， 包 含 从 first 到 second (包含 first 和 second) 之 间 的 整数 或 字符 
a FE first 小 ， 则 返回 反 序 的 数组 。 


例子 1 


<?php 

$number = range(0,5); 
print r ($number), 

?> 
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例子 2 


<?php 
$number - range(0,50,10), 
print r ($number); 


?» 

输出 : 
Array 
( 
[0] => © 
[1] => 10 
[2] => 20 
[3] => 30 
[4] => 40 
[5] => 50 


例子 3 


<?php 

$letter = range("a","d"); 
print_r ($letter); 

?> 
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PHP reset() E32 


定义 和 用 法 
reset() 函数 把 数组 的 内 部 指针 指向 第 一 个 元 素 ， 并 返回 这 个 元 素 的 值 。 


若 失败 ， 则 返回 FALSE, 


语法 


reset(array) 


参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


例子 


<?php 
$people = array("Peter", "Joe", "Glenn", "Cleveland"), 


echo current($people) . "<br />"; 
echo next($people) . "<br />", 
echo reset ($people), 

?> 


输出 : 


Peter 
Joe 
Peter 


PHP rsort() 函数 


oh 、 : 
定义 和 用 法 

rsort() 函数 对 数组 的 元 素 按照 键 值 进行 逆向 排序 。 与 arsort() 的 功能 基本 相同 。 

注释 : 该 函数 为 array 中 的 单元 赋予 新 的 键 名 。 这 将 删除 原 有 的 键 名 而 不 仅 是 重新 排序 。 
如 果 成 功 则 返回 TRUE， 否则 返回 FALSE, 


可 选 的 第 二 个 参数 包含 另外 的 排序 标志 。 
语法 


rsort(array,sorttype) 


参数 描述 
array 必需 。 输 入 的 数组 。 
可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 
sorttype 来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC -把 值 作为 数字 来 处 理 


来 处 理 ， 基 于 本 地 设置 *。 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 在 PHP 6 之 前 ， 使 用 了 系统 的 区 域 设置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc_set_default() 2X. 


例子 


<?php 

$my_array = array("a" => "Dog", "np => “catur MM, => "Horse"); 
rsort($my array); 

print r($my array); 

?> 


输出 : 


Array 


[0] => Horse 
[1] => Dog 
[2] => Cat 


SORT. STRING - 把 值 作为 字符 串 来 处 理 SORT LOCALE STRING - 把 值 作为 字符 串 


PHP shuffle() 2X 


定义 和 用 法 

shuffle() 范 数 把 数组 中 的 元 素 按 随机 顺序 重新 排列 。 

若 成 功 ， 则 返回 TRUE， 否则 返回 FALSE, 

注释 : 本 男 数 为 数组 中 的 单元 赋予 新 的 键 名 。 这 将 删除 原 有 的 键 名 而 不 仅 是 重新 排序 。 


注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() 函数 给 随机 数 发 生 器 播种 ， 现 已 
被 自动 完成 。 


语法 
shuffle(array) 
参数 描述 
array 必需 。 规 定 要 使 用 的 数组 。 


例子 


<?php 

$my_array = array("a" => "Dog", EH —> "Cat", res => "Horse"); 
shuffle($my_array); 

print_r($my_array); 

?> 


输出 : 


Array ( [0] => Cat [1] => Horse [2] => Dog ) 


PHP sizeof() 函数 


定义 和 用 法 


sizeof() 函数 计算 数组 中 的 单元 数目 或 对 象 中 的 属性 个 数 。 


ik AE count() 的 别名 。 
语法 


sizeof(array,mode) 


描述 


o -默认 。 不 检测 多 维 数组 〈 数 组 中 的 数 


参数 
array 必需。 规定 要 计数 的 数组 或 对 象 。 
mode Tie MERAMA. THAD : 


提示 和 注释 


i - 检测 多 维 数 组 。 注 释 : 该 参数 是 PHP 4.2 中 加 入 的 。 


注释 : 当 变量 未 被 设置 ， 或 是 变量 包含 一 个 空 的 数组 ， 该 画 数 会 返回 0。 可 使 用 isset() 变量 


来 测试 变量 是 否 被 设置 。 


例子 


<?php 
$people = array("Peter", "Joe", "Glenn", 
$result = sizeof ($people), 


echo $result, 
?» 


输出 : 


"Cleveland"); 


PHP sort() KŻ 


rm . 3 

定义 和 用 法 

sort() 函数 按 升序 对 给 定数 组 的 值 排序 。 

注释 : 本 函数 为 数组 中 的 单元 赋予 新 的 键 名 。 原 有 的 键 名 闻 被 删除 。 
如 果 成 功 则 返回 TRUE， 否则 返回 FALSE, 

语法 


sort( array , sorttype ) 


参数 描述 
array 必需 。 输 入 的 数组 。 


可 选 。 规 定 如 何 排列 数组 的 值 。 可 能 的 值 : SORT REGULAR - 默认 。 以 它们 原 


sorttype 
来 处 理 ， 基 于 本 地 设置 *。 


来 的 类 型 进行 处 理 (不 改变 类 型 ) 。 SORT NUMERIC - 把 值 作为 数字 来 处 理 
SORT. STRING - 把 值 作为 字符 串 来 处 理 SORT LOCALE STRING - 把 值 作为 字符 串 


* : 该 值 是 PHP 4.4.0 和 5.0.2 新 加 的 。 在 PHP 6 之 前 ， 使 用 了 系统 的 区 域 设置 ， 可 以 用 
setlocale() 来 改变 。 自 PHP 6 起 ， 必 须 用 i18n_loc_set_default() 函数 。 


例子 


<?php 
$my_array = array("a" => "Dog", Why => "Cat", TER => "Horse"); 


sort($my array), 
print r($my array), 
?» 


PHP uasort() šk 


定义 和 用 法 


uasort() 函数 使 用 用 户 自 定义 的 比较 函数 对 数组 排序 ， 并 保持 素 引 关联 〈 不 为 元 素 分 配 新 的 
键 ) 。 


如 果 成 功 则 返回 TRUE， 否则 返回 FALSE. 


该 画 数 主要 用 于 对 那些 单元 顺序 很 重要 的 结合 数组 进行 排序 。 
语法 


uasort(array, sorttype) 


参数 描述 
array 必需 。 规 定 要 排序 的 数组 。 


function 


Wie. FP BELKA. 


函数 必须 设计 为 返回 -1, 0, 或 1， 并 应 该 接受 两 个 供 比较 的 参数 ， 同 时 以 类 似 下 面 这 样 的 方式 
来 工作 : 如 果 a = b, 返回 0 ; 如 果 a < b, 返回 1 ; 如 果 a>b, 返回 -1。| 


例子 


<?php 
function my sort($a, $b) 


if ($a -- $b) return 0; 

return ($a > $b) ? -1 : 1, 

} 
$people = array("Swanson" => "Joe", 
"Griffin" => "Peter", "Quagmire" => "Glenn", 
"swanson" => "joe", "griffin" => "peter", 
"quagmire" => "glenn"); 
uasort($people, "my_sort"); 


print_r ($people); 
?> 


输出 : 


Array 


[griffin] -» peter 
[swanson] -» joe 
[quagmire] -» glenn 
[Griffin] -» Peter 
[Swanson] -» Joe 
[Quagmire] -» Glenn 


PHP uksort() 函数 


定义 和 用 法 

uksort() 范 数 使 用 用 户 自 定义 的 比较 函数 按照 键 名 对 数组 排序 ， 并 保持 索引 关系 。 
如 果 成 功 则 返回 TRUE, BARE] FALSE, 

如 果 要 排序 的 数组 需要 用 一 种 不 寻常 的 标准 进行 排序 ， 那 么 应 该 使 用 此 函数 。 


自 定义 事 数 应 接受 两 个 参数 ， 该 参数 闻 被 数组 中 的 一 对 键 名 填充 。 上 比较 玉 数 在 第 一 个 参数 小 
于 ， 等 于 ， 或 大 于 第 二 个 参数 时 必须 分 别 返 回 一 个 小 于 需 ， 等 于 需 ， 或 大 于 规 的 整数 。 


语法 


uksort(array, sorttype) 


参数 描述 
array 必需 。 规 定 要 排序 的 数组 。 


必需 。 用 户 自 定 义 的 函数 。 画 数 必 须 设 计 为 返回 -1, 0, 或 1， 并 应 该 接受 两 个 
function ” 供 比 较 的 参数 ， 同 时 以 类 似 下 面 这 样 的 方式 来 工作 : IR a = b, 返回 0 ; 如 
Ra>b, RIE] 1: 如 果 a<b, 返回 -1。 


例子 


<?php 
function my sort($a, $b) 


t 

if ($a -- $b) return 0; 

return ($a > $b) ? -1 : 1, 

} 
$people = array("Swanson" => "Joe", 
"Griffin" => "Peter", "Quagmire" => "Glenn", 
"swanson" => "joe", "griffin" => "peter", 
"quagmire" => "glenn"); 
uksort($people, "my_sort"); 


print_r ($people); 
?> 


输出 : 


Array 

( 

[Swanson] => joe 
[quagmire] => glenn 
[griffin] => peter 
[Swanson] => Joe 
[Quagmire] => Glenn 
[Griffin] => Peter 


) 


PHP usort() KŻ 


定义 和 用 法 
usort() 函数 使 用 用 户 自 定义 的 函数 对 数组 排序 。 


注释 : 如 果 两 个 元 素 比 较 结果 相同 ， 则 它们 在 排序 后 的 数组 中 的 顺序 未 经 定义 。 到 PHP 4.0.6 
之 前 ， 用 户 自 定义 函数 将 保留 这 些 元 素 的 原 有 顺序 。 但 是 由 于 在 4.1.0 中 引进 了 新 的 排序 算 
法 ， 结果 将 不 是 这 样 了 ， 因为 对 此 没有 一 个 有 效 的 解决 方案 。 


注释 : AWRY array 中 的 元 素 赋予 新 的 键 名 。 这 会 删除 原 有 的 键 名 。 
语法 


usort(array, sorttype) 


参数 描述 
array 必需 。 规 定 要 排序 的 数组 。 
必需 。 用 户 自 定义 的 范 数 。 男 数 必须 设计 为 返回 -1, 0, 或 1， 并 应 该 接受 两 个 


function ” 供 比 较 的 参数 ， 同 时 以 类 似 下 面 这 样 的 方式 来 工作 : IR a z b, 返回 0 ; 如 
Ra>b, 返回 1; AIR a «b, 返回 -1。 


例子 


<?php 
function my sort($a, $b) 


{ 
if ($a == $b) return 0; 


return ($a > $b) ? -1 : 1; 
J 


$arr = array("Peter", "glenn", "Cleveland", "peter", "cleveland", "Glenn"); 
usort($arr, "my sort"), 


print r ($arr), 
?» 


输出 : 


peter 
glenn 
cleveland 
Peter 
Glenn 
Cleveland 


PHP Calendar 函数 


PHP Calendar 简介 
当 使 用 不 同 的 历法 格式 时 ，calendar KAURAA. CHE TAKÉ ef Be H iT 2X (Julian day 
count), 


编者 注 : Julian day count 是 从 January 1, 4713 B.C. 开始 计算 的 ， 中 文 译 为 儒 略 日 计数 或 恺 
撒 日 计数 。 


请 注意 ，Julian day count (AA+) 与 Julian calendar (4888/5) 不 是 一 回 事 。 


注释 : 如 需 在 日 历 格 式 之 间 转 换 ， 必 须 首 先 转换 为 Julian day count， 然 后 再 转换 为 日 历 格 
式 。 

mo yt 

QR 


PHP 的 windows 版 本 已 内 建 了 对 日 历 扩 展 的 支持 。 因 此 ，Calendar 函数 会 自动 工作 。 


不 过 ， 如 果 您 运行 的 是 PHP 的 Linux 版 本 ， 就 不 得 不 通过 --enable-calendar 编译 PHP， 这 
样 日 历 画 数 才 能 工作 。 


PHP Calendar 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


Až 
cal days in month() 
cal from jd() 
cal info() 
cal to jd() 
easter date() 
easter days() 
FrenchToJD() 
GregorianToJD() 
JDDayOfWeek() 
JDMonthName() 
JDToFrench() 
JDToGregorian() 
jdtojewish() 
JDToJulian() 
jdtounix() 
JewishToJD() 
JulianToJD() 


unixtojd() 


描述 
针对 指定 的 年 份 和 日 历 ， 返 回 一 个 月 中 的 天 数 。 
把 儒 略 日 计数 转换 为 指定 日 历 的 日 期 。 
返回 有 关 给 定 日 历 的 信息 。 
把 日 期 转换 为 儒 略 日 计数 。 
返回 指定 年 份 的 复活 节 午夜 的 Unix ay i8] El. 
返回 指定 年 份 的 复活 节 和 与 3 月 21 日 之 间 的 天 数 。 
将 法 国共 和 历法 转换 成 为 儒 略 日 计数 。 
将 格 利 高 里 历法 转换 成 为 儒 略 日 计数 。 
返回 日 期 在 周 几 。 
返回 月 的 名 称 。 
把 儒 略 日 计数 转换 为 法 国共 和 国 历 法 。 
把 儒 略 日 计数 转换 为 格 利 高 里 历法 。 
把 儒 略 日 计数 转换 为 犹太 历法 。 
把 儒 略 日 计数 转换 为 儒 略 历 。 
把 儒 略 日 计数 转换 为 Unix at ia) Sis 
把 犹太 历法 转换 为 儒 略 日 计数 。 
把 儒 略 历 转 换 为 儒 略 日 计数 。 
把 Unix 时 间 惟 转换 为 儒 略 日 计数 。 


PHP Calendar 常量 


PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 


PHP 


a C CQ A U OU OU CQ 0 0 CQ wo CQ wo fF A A DA 


Ho 


常 
CAL_GREGORIAN 
CAL. JULIAN 
CAL JEWISH 
CAL FRENCH 
CAL NUM CALS 
CAL DOW DAYNO 
CAL DOW SHORT 
CAL DOW LONG 
CAL MONTH GREGORIAN SHORT 
CAL MONTH GREGORIAN LONG 
CAL MONTH JULIAN SHORT 
CAL MONTH JULIAN LONG 
CAL MONTH JEWISH 
CAL MONTH FRENCH 
CAL EASTER DEFAULT 
CAL EASTER DEFAULT 
CAL EASTER ROMAN 
CAL EASTER ALWAYS GREGORIAN 
CAL EASTER ALWAYS JULIAN 
CAL JEWISH ADD ALAFIM GERESH 
CAL JEWISH ADD ALAFIM 
CAL JEWISH ADD GERESHAYIM 


Gregorian calendar 
Julian calendar 
Jewish calendar 


French Republican calendar 


a a U BB A A A A U Q U U U WwW 0 WwW WwW OQ 


PHP cal days in month() 2 
定义 和 用 法 

cal days in month() 函数 针对 指定 的 年 份 和 日 万， 返回 一 个 月 中 的 天 数 。 
语法 


cal days in month(calendar,month, year) 


参数 描述 
calendar 必需 。 规 定 要 使 用 的 历法 。 
month 必须 。 规 定 月 。 
year 必须 。 规 定年 。 


例子 


<?php 

$d-cal days in month(CAL GREGORIAN, 10, 2005), 
echo("There was $d days in October 2005"); 
?> 


输出 : 


There was 31 days in October 2005 


PHP cal from jd() Ei2 
定义 和 用 法 

cal from jd() 函数 把 儒 上 略 日 计数 转换 为 指定 历法 的 日 期 。 
语法 


cal from jd(jd,calendar) 


参数 描述 
jd 必需 。 一 个 数字 〈 儒 略 日 计数 ) 。 


必需 。 规 定 要 使 用 的 历法。 可 以 使 用 下 面 这 些 常量 : CAL GREGORIAN 


CAL JULIAN CAL JEWISH CAL FRENCH 


calendar 


例子 


<?php 
$d-unixtojd(mktime(0,0,0,1,18,2006)); 
print r(cal from jd($d, CAL GREGORIAN)); 
?> 


输出 : 


Array 

( 

[date] -» 1/18/2006 
[month] -» 1 


[day] -» 18 
[year] -» 2006 
[dow] => 3 


[abbrevdayname] => Wed 
[dayname] => Wednesday 
[abbrevmonth] => Jan 

[monthname] => January 


) 


PHP cal info() 函数 


ch 、 : 
cal info() 画 数 返回 一 个 数组 ， 其 中 包含 了 关于 给 定 历法 的 信息 。 


所 返回 的 数组 包含 这 些 元 素 : calname, calsymbol, month, abbrevmonth 以 及 
maxdaysinmonth. 


语法 


cal from jd(jd, calendar ) 


参数 描述 


必需 。 规 定 要 使 用 的 历法。 可 以 使 用 下 面 这 些 常量 : CAL GREGORIAN 
CAL JULIAN CAL JEWISH CAL FRENCH 


calendar 


提示 和 注释 


提示 : 在 PHP 5 中 ， 如 果 没 有 指定 calendar 参数 ， 则 返回 所 有 被 支持 的 历法 的 信息 。 


例子 


<?php 

$calinfo-cal info(0); 
print r($calinfo), 

?> 


输出 : 


Array 


[months] -» Array 
( 

[1] => January 
[2] => February 
[3] => March 

[4] => April 


[5] => May 
[6] => June 
[7] => July 


[8] => August 

[9] => September 
[10] => October 
[11] => November 
[12] => December 


) 


[abbrevmonths] => Array 


( 


[1] => Jan 
[2] => Feb 
[3] => Mar 
[4] => Apr 
[5] => May 
[6] => Jun 
[7] => Jul 
[8] => Aug 
[9] => Sep 
[10] => Oct 
[11] => Nov 
[12] => Dec 


) 


[maxdaysinmonth] => 31 
[calname] => Gregorian 
[calsymbol] => CAL_GREGORIAN 


) 


PHP cal to jd() HX 
定义 和 用 法 

cal to jd() 函数 把 指定 的 日 期 转换 为 儒 略 日 计数 。 
语法 


cal to jd(calendar,month, day, year) 





参数 描述 
aenda 必需 。 规 定 要 使 用 的 历法。 可 以 使 用 下 面 这 些 常量 CAL GREGORIAN 
CAL JULIAN CAL JEWISH CAL FRENCH 
month 必需 。 规 定 月 。 
day 必需 。 规 定 日 。 
year 必需 。 规 定年 。 
例子 
<?php 
$d-cal to jd(CAL GREGORIAN, 10, 03, 2005); 
echo($d), 
2 
输出 : 


2453647 


PHP easter date() 函数 


定义 和 用 法 
easter date() 函数 返回 指定 年 份 的 复活 节 午 夜 的 Unix a i Sie 


输入 一 个 年 份 ， 则 以 UNIX 时 间 戳 记 的 格式 返回 该 年 的 复活 节日 期 ， 若 没有 输入 年 份 ， 则 计 
算 当 年 的 日 期 。 


语法 


easter date(year) 


参数 描述 
year 可 选 。 定 义 用 于 计算 复活 节日 期 的 年 份 。 若 省 略 ， 使 用 当年 。 


提示 和 注释 


注释 : 如 果 年 份 在 Unix 时 间 惟 的 范围 之 外 (1970 之 前 或 2037 ZE) ， 该 男 数 会 生成 一 个 警 
告 。 可 使 用 easter days() 代替 easter date() 来 计算 年 份 在 范围 之 外 的 复活 节日 期 。 


例子 


<?php 

echo(easter date() . "<br />"); 
echo(date("M-d-Y",easter date()) . "<br />"); 
echo(date("M-d-Y",easter date(2000)) . "<br /»"); 
echo(date("M-d-Y",easter date(2001)) . "<br /»"); 
echo(date("M-d-Y",easter date(2002))); 

?> 


输出 : 


1145138400 

Apr -16-2006 
Apr -23-2000 
Apr-15-2001 
Mar -31-2002 


PHP easter days() 函数 


定义 和 用 法 
easter days() 函数 返回 指定 年 份 的 复活 节 与 3 月 21 日 之 间 的 天 数 。 


输入 一 个 年 份 ， 则 计算 该 年 复活 节 与 三 月 二 十 一 日 之 间 的 日 期 数 ， 若 没有 输入 年 份 ， 则 以 当 
年 计算 。 这 个 画 数 可 以 用 来 替代 easter date() 在 1970-2037 年 范围 外 无 法 计算 的 问题 。 


语法 


easter date(year) 


参数 描述 
year 可 选 。 定 义 用 于 计算 复活 节日 期 的 年 份 。 若 省 略 ， 使 用 当年 。 


可 选 。 人 允许 你 计算 机 与 其 它 历 法 的 复活 节日 期 。 例 如 ， 如 果 设 置 为 
CAL EASTER ROMAN， 则 使 用 1582 - 1752 年 期 间 的 格 利 高 里 历法 。 


例子 


<?php 

echo(easter days() . "<br />"), 
echo(easter days(1990) . "<br /»"); 
echo(easter days(1342) . "<br />"), 
echo(easter days(2050), 

?> 


输出 : 


26 
25 
10 
20 


PHP FrenchToJD() 函数 
定义 和 用 法 

FrenchToJD() 函数 将 法 国共 和 历法 转换 成 为 儒 略 日 计数 。 
语法 


frenchtojd(month, day, year) 


参数 描述 
month 必需 。 规 定 月 
day 必需 。 规 定 日 
year 可 选 。 必 须 在 1 到 14 的 范围 内 。 


提示 和 注释 


法 国共 和 历法 是 法 国 革命 期 间 提出 的 一 种 历法 ， 从 1793 年 晚期 开始 ， 法 国政 府 使 用 了 大 约 
12, WMA 1 到 14 年 内 的 日 期 ( 格 利 高 里 历 1792 F 9A 22 H - 1806 #9 H 22 
日 ) o 


例子 


<?php 
$d-frenchtojd(3, 3, 14): 
echo($d); 

?> 


输出 : 


2380650 


PHP GregorianToJD() 函数 
定义 和 用 法 

GregorianToJD() 函数 将 格 利 高 里 历法 转换 成 为 儒 上 略 日 计数 。 
语法 


gregoriantojd(month, day, year) 


参数 描述 
month 必需 。 规 定 月 
day 必需 。 规 定 日 
year 可 选 。 合 法 的 范围 是 4714 B.C. 到 9999 A.D, 


提示 和 注释 


RE AWA RE 4714 B.C. 之 前 的 日 期 ， 您 还 是 要 注意 格 利 高 里 历法 在 1582 年 才 建 立 ， 一 
些 国 家 甚至 更 晚 才 接 受 它 〈 大 不 列 颠 在 1752 年 ， 苏 联 在 1918 年 ， 希 腊 在 1923 F) 。 大 部 
分 欧洲 国家 使 用 罗马 儒 略 历 〈 公 历 ) 先 于 格 利 高 里 历法 。 


例子 


<?php 
$jd = gregoriantojd(10, 3, 1975), 
echo($jd . "<br />"), 


$gregorian - jdtogregorian($jd); 
echo($gregorian); 
?> 


输出 : 


2442689 
10/3/1975 


PHP JDDayOfWeek() 函数 


定义 和 用 法 


JDDayOfWeek() E23 [pl A RB TEA] [Lo 


语法 
jddayofweek(jd, mode) 
参数 描述 
jd 必需 。 数 字 〈 儒 略 日 计数 ) 。 


可 选 。 定 义 返 回 的 内 容 (数字 还 是 字符 串 ) 。 模 式 值 : 0 -默认 。 以 整数 返回 
mode IBA, (0 为 周 日 , 1 为 周一 … RAH) 1 - 返回 包含 周 的 天 的 字符 串 。 (A 
文 - 格 里 高 里 历 ) 2 - 返回 包含 周 的 天 的 简写 的 字符 串 。 (英文 - 格 里 高 里 历 ) 


例子 


<?php 

$jd=cal_to_jd(CAL_GREGORIAN, date("m"),date("d"),date("Y")); 
echo(jddayofweek($jd,1)); 

?> 


输出 : 


Thursday 


PHP JDMonthName() HŽ% 


Lr. N 
定义 和 用 法 
JDMonthName() 沙 数 返回 指定 历法 的 月 份 字符 串 。 
语法 
jdmonthname(jd,mode) 
参数 描述 


jd Ws. Xe 〈 儒 略 日 计数 ) 。 


ES 
Tuo 
可 选 。 定 义 把 儒 略 日 计数 转换 为 哪 种 历法 ， 以 及 返回 哪 种 月 份 名 称 。 模 式 
值 : o - 格 里 高 里 历 (缩写 ) (Jan, Feb, Mar, ...) 1 - 格 里 高 里 历 (January, 
mode February, March, ...) 2 - Suus (缩写 ) (Jan, Feb, Mar, ...) 3 -凯撒 历 
(January, February, March, ...) 4 - 犹太 历 (Tishri, Heshvan, Kislev, ...) 5 -法 
国共 和 历 (Vendemiaire, Brumaire, Frimaire, ...) 


例子 


<?php 

$jd-cal to jd(CAL GREGORIAN, date("m"),date("d"),date("Y")); 
echo(jdmonthname($jd,1)); 

?> 


输出 : 


January 


PHP JDToFrench() 函数 


定义 和 用 法 


JDToFrench() 函数 把 儒 上 略 日 计数 转换 为 法 国共 和 国 历法 。 


语法 
jdtofrench(jd) 
参数 描述 
jd 必需 。 数 字 〈 儒 略 日 计数 ) 。 


H 一 Mrs. 
提示 和 注释 : 
注释 : ZAŠLI "month/day/year" 的 格式 返回 一 个 字符 串 。 


提示 : 法 国共 和 历法 是 法 国 革命 期 间 提 出 的 一 种 历法 ， 从 1793 年 晚期 开始 ， 法 国政 府 使 用 了 
KY 12 年 。 


例子 


<?ph 
$d-jdtofrench(2380650); 
echo($d); 

?> 


输出 : 


3/3/14 


PHP JDToGregorian() 函数 


定义 和 用 法 


JDToGregorian() 函数 把 儒 略 日 计数 转换 为 格 利 高 里 历法 。 


语法 
jdtogregorian(jd) 
BR 描述 
jd 必需 。 数 字 〈 儒 略 日 计数 ) 。 


提示 和 注释 : 


注释 : REALL "month/day/year" 的 格式 返回 一 个 字符 串 。 


例子 


<?php 
$jd = gregoriantojd(10, 3, 1975), 
echo($jd . "<br />"), 


$gregorian - jdtogregorian($jd); 


echo($gregorian); 
?> 


输出 : 


2442689 
10/3/1975 


PHP JDToJewish() 2X 


定义 和 用 法 


JDToJewish() 函数 把 儒 略 日 计数 转换 为 犹太 历法 


语法 

JDToJewish(jd) 

参数 描述 
jd 必需 。 数 字 ( 儒 略 日 计数 ) 。 


hebrew ”可 选 。True 指示 希 伯 来 语 输 出 格式 。 
可 选 。 定 义 希 伯 来 语 输出 格式 ， 可 用 的 格式 有 : 


fl CAL JEWISH ADD ALAFIM GERESH CAL JEWISH ADD ALAFIM 
CAL JEWISH ADD GERESHAYIM 





例子 


<?php 
echo(jdtojewish(gregoriantojd(10,8,2002))): 
?> 


输出 : 


2/2/5763 


PHP JDToJulian() ES25 


定义 和 用 法 


JDToJulian() HAGE EHS EJ i+ Mee HKG. 


语法 
JDToJulian(jd) 
参数 描述 
jd 必需 。 数 字 〈 儒 略 日 计数 ) 。 


提示 和 注释 : 


注释 : REALL "month/day/year" 的 格式 返回 一 个 字符 串 。 


例子 


<?php 
$jd = juliantojd(10, 3,1975), 
echo($jd . "<br />"), 


$julian - jdtojulian($jd); 
echo($julian); 
?> 


输出 : 


2442702 
10/3/1975 


PHP JDToUnix() 函数 


定义 和 用 法 


JDToUnix() 函数 把 儒 略 日 计数 转换 为 Unix it ja] 


语法 
JDToUnix(jd) 
参数 描述 
jd 必需 。 数 字 〈 儒 略 日 计数 ) 。 


提示 和 注释 : 


注释 : 如 果 参 数 jd 不 在 Unix 新 纪元 之 中 (意味 着 格 利 高 里 年 必须 介 于 1970 和 2037 之 间 ， 
或 者 jd >= 2440588 H jd <= 2465342) ， 则 该 图 数 将 返回 false。 所 返回 的 时 间 是 本 地 时 
间 。 


例子 


<?php 

$jd = gregoriantojd(10, 3, 1970), 
$unix - jdtounix($jd); 
echo($unix), 

?> 


输出 : 


23760000 


PHP JewishToJD() 2X 


定义 和 用 法 


JewishToJD() ESZI E XI, I 75 3 Es He HIE i+ Bh 


语法 
JDToUnix(jd) 
参数 描述 
month 必需 。 规 定 月 。 
day 必需 。 规 定 日 。 
year 必需 。 规 定年 。 


提示 和 注释 : 


注释 : 有 效 的 范围 为 犹太 历法 公元 前 3761 年 起 。 犹 太 历法 存在 了 数 千 年 ， 但 早期 并 没有 公式 
化 的 开始 月 份 计 算法 。 每 年 的 第 一 个 月 为 首次 观测 到 的 新 月 。 


例子 


<?php 
echo( jewishtojd(2,2,5763)); 
?> 


2452556 


PHP JulianToJD() E25 


定义 和 用 法 


JulianToJD() HAE Eis Hee HEA i+ Be 


语法 
JDToUnix(jd) 
参数 描述 
month 必需 。 规 定 月 。 
day 必需 。 规 定 日 。 
year 必需 。 规 定年 。 合 法 的 范围 是 4713 B.C. 到 9999 A.D. 


提示 和 注释 : 


定 下 来 。 


例子 


<?php 
$jd = juliantojd(10, 3, 1975), 
echo($jd . "<br /»"); 


$julian - jdtojulian($jd); 
echo($julian); 
?> 


au : 


2442702 
10/3/1975 


PHP UnixToJD() 函数 
定义 和 用 法 

UnixToJD() 函数 把 Unix 时 间 惟 转换 为 儒 略 日 计数 。 
语法 


unixtojd(timestamp) 


timestamp 可 选 。 


提示 和 注释 : 


注释 : Unix 时 间 惟 指示 的 是 从 格 利 高 里 历 (TEF DARA) 的 1970 年 1 月 1 日 至 今 的 秒 
数 。 


例子 


<?php 
echo(unixtojd()); 
> 


2453755 


PHP cURL WH 


概述 
PHP 支 持 的 由 Daniel Stenberg 创 建 的 libcurl 库 允许 你 与 各 种 的 服务 器 使 用 各 种 类 型 的 协议 进行 
连接 和 通讯 。 


libcurl 目 前 支持 http、https、ftp、gopher、telnet、dict、file 和 Idap 协 议 。libcurl 同 时 也 支持 
HTTPS 认 证 、HTTP POST, HTTP PUT, FTP 上 传 ( 这 个 也 能 通过 PHP 的 FTP 扩 展 完成 )、 
HTTP 基于 表单 的 上 传 、 代 理 、cookies 和 用 户 名 + 密码 的 认证 。 


PHP 中 使 用 cURL 实现 Get 和 Post 请 求 的 方法 


3x LE BG AYZEPHP 4.0.2 中 被 引入 。 


为 了 使 用 PHP 的 cURL 男 数 ， 你 需要 安装 ? libcurl 包 。 


PHP 需 要 使 用 libcurl 7.0.2-beta 或 者 更 高 版 本 。 在 PHP 4.2.3 里 使 用 cURL， 你 需要 安装 7.9.0 
或 更 高 版 本 的 libcurl。 从 PHP 4.3.0 开 始 你 需要 安装 7.9.0 或 更 高 版 本 的 libcurl。 从 PHP 5.0.0 开 
始 你 需要 安装 7.10.5 或 更 高 版 本 的 libcurl。 


mo yt 

安装 

要 使 用 PHP 的 cURL 支持 你 必须 在 编译 PHP 时 加 上 --with-curl[=DIR] 选项 ，DIR 为 包含 ib 和 
include 的 目录 路 径 。 在 include 目 录 中 必须 有 一 个 名 为 curl， 包 含 了 easy.h 和 curl.h 的 文件 夹 。 


lib 文 件 夹 里 应 该 有 一 个 名 为 libcurl.a 的 文件 。 对 于 PHP 4.3.0 你 可 以 配置 --with-curlwrappers 使 
cURL 使 用 URL 流 。 


注意 : Win32 用 户 注意 要 在 Windows 环 境 下 使 用 这 个 模块 ，libeay32.dll 和 ssleay32.dll 必 须 放 到 
PATH 环境 变量 包含 的 目录 下 。 不 用 cURL 网 站 上 的 libcurl.dll。 


这 个 扩展 定义 了 2 中 资源 : cURL 句柄 和 cURL 批 处 理 句柄 。 


PHP cURL 函数 


以 下 包含 了 PHP CURLEGÁKZI K : 


W3School PHP 参考 手册 


Až 
curl close() 
curl copy handle() 
curl errno() 
curl error() 
curl escape() 
curl exec() 
curl file create() 
curl getinfo() 
curl init() 
curl multi add handle() 
curl multi close() 


curl multi exec() 
curl multi getcontent() 


curl multi info read() 
curl multi init() 

curl multi remove handle() 
curl multi select() 

curl multi setopt() 

curl multi strerror() 
curl pause() 

curl reset() 

curl setopt array() 
curl setopt() 

curl share close() 
curl share init() 

curl share setopt() 
curl strerror() 

curl unescape() 


curl version() 


PHP cURL 函数 


X 闭 一 个 cURL 会 to 
复制 一 个 cURL 句 柄 和 它 的 所 有 选项 。 


返回 一 次 的 错 ; 误 写 。 
返回 一 个 保护 当前 会 话 最 近 一 次 错误 的 字符 串 。 
返回 转 义 字符 串 ， 对 给 定 的 字符 串 进 行 URL 编 码 。 


执行 一 个 CURL 会 话 。 

创建 一 个 CURLFile 对 象 。 

获取 一 个 cURL 连 接 资 源 句 柄 的 信息 。 
初始 化 一 个 cURL 会 话 。 

向 curl 批 处 理会 话 中 添加 单独 的 curl 句 柄 。 
关闭 一 组 CURL 句 柄 。 

运行 当前 CURL 句柄 的 子 连接 。 


如 果 设 置 了 CURLOPT_RETURNTRANSFER， 则 返 
取 的 输出 的 文本 流 。 


获取 当前 解析 的 cURL 的 相关 传输 信息 。 

一 个 新 cCURL 批 处 理 句 柄 。 
移 除 curl 批 处 理 句柄 资源 中 的 某 个 句柄 资源 。 
等 待 所 有 cURL 批 处 理 中 的 活动 连接 。 
ik i& — T Hb A HECURL ££ 48 x 

返回 描述 错误 码 的 字符 串 文 本 。 
暂停 及 恢复 连接 。 
重 置 libcurl 的 会 话 句柄 的 所 有 选项 。 
为 CURL 传 输 会 话 批量 设置 选项 
设置 一 个 cURL 传输 选项 。 
关闭 CURL 共 享 句柄 。 
初始 化 cURL 共 享 句柄 。 
设置 一 个 共享 句柄 的 cCURL 传 输 选 项 。 
返回 错误 代码 的 字符 串 描 述 。 
解码 URL 编 码 后 的 字符 串 。 
获取 cURL 版 本 信息 。 


区 回 获 


选项 o 


168 


PHP curl closeP24 


(PHP 4 >= 4.0.2, PHP 5) 


curl close 一 天 闭 一 个 CURL 会 话 
说 明 
void curl close ( resource $ch ) 


关闭 一 个 cURL 会 话 并 且 释 放 所 有 资源 。cURL 句 柄 ch 也 会 被 释放 。 


参数 


ch 


由 curl. init() 返回 的 cURL 句柄 。 


TRIE) f 


没有 返回 值 。 


实例 
初始 化 一 个 cURL 会 话 来 获取 一 个 网 页 


<?php 
// 创建 一 个 新 cURL 资源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 
curl setopt($ch, CURLOPT URL, "http://www.w3cschool.cc/"); 
curl setopt($ch, CURLOPT HEADER, 0), 


// 抓 取 URL 并 把 它 传递 给 浏览 器 
curl exec($ch), 


// 关闭 cURL 资 源 ， 并 且 释放 系统 资源 
curl close($ch); 
?» 


y 


见 


W3School PHP 参考 手册 


e curl init() - 初始 化 一 个 cURL 会 话 
e curl multi close() - 关闭 一 组 cURL 句柄 
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PHP curl copy handlePq23 


(PHP 5) 


curl, copy. handle 一 复制 一 个 cURL 句 柄 和 它 的 所 有 选项 
说 明 
resource curl copy handle ( resource $ch ) 


复制 一 个 cURL 句柄 并 保持 相同 的 选项 。 


参数 


ch 


由 curl. init() 返回 的 cURL 句柄 。 


3 [E] f 


返回 一 个 新 的 cCURL 句 柄 。 


实例 
复制 一 个 cURL 句柄 


<?php 
// 创建 一 个 新 的 cURL 资源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 
curl setopt($ch, CURLOPT URL, 'http://www.example.com/'); 
curl setopt($ch, CURLOPT HEADER, 0), 


// 复制 句柄 
$ch2 = curl copy handle($ch), 


// 抓 取 URL (http://www.example.com/) 并 把 它 传递 给 浏览 器 
curl exec($ch2); 


// 关闭 cURL 资 源 ， 并 且 释放 系统 资源 
curl close($ch2), 

curl close($ch), 

?> 


PHP curl errnoE2X 


(PHP 4 >= 4.0.3, PHP 5) 


curl_errno 一 返回 最 后 一 次 的 错误 号 
说 明 
int curl errno ( resource $ch ) 


返回 最 后 一 次 cURL 操作 的 错误 号 。 


由 curl. init() 返回 的 cURL 句柄 。 


3 [O] f 


返回 错误 号 或 0 (3m) 如 果 没 有 错误 发 生 。 


实例 


<?php 
// 创建 一 个 指向 一 个 不 存在 的 位 置 的 cCURL 句 柄 
$ch = curl init('http://404.php.net/'); 


// dk 


curl setopt($ch, CURLOPT RETURNTRANSFER, true); 


curl exec($ch), 


// 检查 是 否 有 错误 发 生 
if(curl errno($ch)) 
{ 


} 
// 关闭 句柄 


curl close($ch), 
?> 


echo "Curl error: ' . curl error($ch), 


sh 


见 


e curl error() - 返回 一 个 保护 当前 会 话 最 近 一 次 错误 的 字符 串 
e ? Curl 错误 号 


PHP curl erroržAžk 


(PHP 4 >= 4.0.3, PHP 5) 


curl. error 一 返回 一 个 保护 当前 会 话 最 近 一 次 错误 的 字符 串 
说 明 
string curl error ( resource $ch ) 


返回 一 条 最 近 一 次 cURL 操作 明确 的 文本 的 错误 信息 。 


由 curl. init() 返回 的 cURL 句柄 。 


j& [n] f& 


返回 错误 信息 或 "( 空 字符 串 ) 如 果 没 有 任何 错误 发 


实例 


<?php 

// pcm 个 指向 一 个 不 存在 的 位 置 的 CURL 句 柄 

$ch = curl init('http://404.php.net/'); 

curl setopt($ch, CURLOPT RETURNTRANSFER, true), 


if(curl exec($ch) --- false) 

echo "Curl error: ' . curl error($ch), 
J 
else 


echo “操作 完成 没有 任何 错误 ' ; 
J 


// 关闭 句柄 
curl close($ch), 
?> 


sh 


见 


W3School PHP 参考 手册 


e curl errno() - 返回 最 后 一 次 的 错误 号 
e ? Curl 错误 代码 
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PHP curl escape4žk 


(PHP 5 >= 5.5.0) 


curl escape — 对 给 定 的 字符 串 进 行 URL 编 码 。 
说 明 
string curl escape ( resource $ch , string $str ) 


该 图 数 对 给 定 的 字符 串 进行 URL 编 码 ? RFC 3986, 


由 curl. init() 返回 的 cURL 句柄 。 
str 


编码 字符 串 


3 [B] (A 


返回 编码 字符 串 ， 或 者 在 失败 时 返回 FALSE, 


实例 


<?php 
// 创建 一 个 cURL 句 柄 
$ch = curl init(); 


// 编码 GET 参 数 
$location = curl escape($ch, 'Hofbr?uhaus / München'); 
// Result: Hofbr%c3%A4uhaus%20%2F%20M%C3%BCnchen 


// 比较 编码 后 的 URL 
$url = "http://example.com/add_location.php?location={$location}"; 
// Result: http://example.com/add_location.php?location=Hofbr%c3%A4uhaus%20%2F%20M%C3%BCn 


// 发 送 HTTP 请 求 并 关闭 句柄 

curl setopt($ch, CURLOPT URL, $url), 

curl setopt($ch, CURLOPT RETURNTRANSFER, true), 
curl exec($ch), 

curl close($ch), 

?> 


JEJE 





PHP curl execb4žk 


(PHP 4 >= 4.0.2, PHP 5) 


curl exec 一 执行 一 个 CURL 会 话 
说 明 
mixed curl exec ( resource $ch ) 


执行 给 定 的 cURL 会 话 。 


这 个 事 数 应 该 在 初始 化 一 个 cURL 会 话 并 且 全 部 的 选项 都 被 设置 后 被 调用 。 


由 curl. init() 返回 的 cURL 句柄 。 


退回 值 
成 功 时 返回 TRUE, 或 者 在 失败 时 返回 FALSE. 然而 ， 如 果 


CURLOPT_RETURNTRANSFER 选 项 被 设置 ， 本 数 执行 成 功 时 会 返回 执行 的 结果 ， 失 败 时 返 
回 FALSE + 


实例 


获取 一 个 网 页 


<?php 
// 创建 一 个 cURL 资源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 
curl setopt($ch, CURLOPT URL, "http://www.w3cschool.cc/"); 
curl setopt($ch, CURLOPT HEADER, 0), 


// 抓 取 URL 并 把 它 传递 给 浏览 器 
curl exec($ch), 


// 关闭 CURL 资 源 ， 并 且 释 放 系 统 资源 
curl close($ch); 
?> 


PHP curl file createPx24 


(PHP 5 >= 5.5.0) 


curl file create 一 创建 一 个 CURLFile xt &. 
说 明 
CURLFile curl file create ( string $filename [, string $mimetype [, string $postname ]] ) 


4 a" [1 
创建 一 个 CURLFile 对 象 , 用 与 上 传 文件 。 


参数 
filename 

上 传 文件 的 路 径 
mimetype 
文件 的 Mimetype 


postname 


文件 名 。 


返回 值 


返回 CURLFile 对 象 。 


实例 


curl file create() 实例 


<?php 

/* http://example.com/upload.php: 
«?php var dump($ FILES); ?» 

EA 


// 创建 一 个 cURL 句柄 
$ch = curl init('http://example.com/upload.php'); 


// 创建 一 个 CURLFile 对 象 
$cfile = curl file create("cats.jpg", "image/jpeg", "test name"), 


// 设置 POST 数据 

$data - array('test file' -» $cfile); 

curl setopt($ch, CURLOPT POST,1); 

curl setopt($ch, CURLOPT POSTFIELDS, $data), 


// 执行 句柄 
curl exec($ch), 
?> 


以 上 例 程 会 输出 : 


array(1) { 

["test file"]-> 

array(5) { 
["name"]-» 
string(9) "test name" 
["type"]-» 
string(10) "image/jpeg" 
["tmp name"]-» 
string(14) "/tmp/phpPC9Kbx" 
["error" ]=> 
int(0) 
["size"]-» 
int(46334) 


PHP curl getinforx24 


(PHP 4 >= 4.0.4, PHP 5) 


curl getinfo 一 获取 一 个 cURL 连接 资源 句柄 的 信息 
说 明 
mixed curl getinfo ( resource $ch [, int $opt = 0 ] ) 


获取 最 后 一 次 传输 的 相关 信息 。 


参数 


ch 

由 curl. init() 返回 的 cURL 句柄 。 
opt 

这 个 参数 可 能 是 以 下 常量 之 一 : 


e CURLINFO EFFECTIVE URL - 最 后 一 个 有 效 的 URL 地 址 

e CURLINFO HTTP CODE - 最 后 一 个 收 到 的 HTTP 代 三 

e CURLINFO FILETIME - 远程 获取 文档 的 时 间 ， 如 果 无 法 获取 ， 则 返回 值 为 "-1" 

e CURLINFO TOTAL TIME - 最 后 一 次 传输 所 消耗 的 时 间 

。 CURLINFO_NAMELOOKUP_TIME - 名 称 解 析 所 消耗 的 时 间 

e CURLINFO CONNECT TIME - 建立 连接 所 消耗 的 时 间 

e CURLINFO PRETRANSFER TIME - 从 建立 连接 到 准备 传输 所 使 用 的 时 间 

e CURLINFO STARTTRANSFER TIME - 从 建立 连接 到 传输 开始 所 使 用 的 时 间 

。 CURLINFO_REDIRECT_TIME - 在 事务 传输 开始 前 重 定向 所 使 用 的 时 间 

e CURLINFO SIZE UPLOAD - 上 传 数据 量 的 总 值 

e CURLINFO SIZE DOWNLOAD - 下 载 数据 量 的 总 值 

e CURLINFO SPEED DOWNLOAD -平均 下 载 速 度 

e CURLINFO SPEED UPLOAD -平均 上 传 速度 

。 CURLINFO_HEADER_SIZE - header 部 分 的 大 小 

e CURLINFO HEADER OUT - 发 送 请 求 的 字符 串 

e CURLINFO REQUEST SIZE - 在 HTTP 请 求 中 有 问题 的 请 求 的 大 小 

e CURLINFO SSL VERIFYRESULT - 通过 设置 CURLOPT_SSL_VERIFYPEER 返 回 的 
SSL 证 书 验证 请 求 的 结果 


e CURLINFO CONTENT LENGTH DOWNLOAD - MContent-Length: field rh iz: EXBY F R, 
内 容 长 度 

e CURLINFO CONTENT LENGTH UPLOAD - 上 传 内 容 大 小 的 说 明 

e CURLINFO CONTENT TYPE - 下 载 内 容 的 Content-Type: 值 ，NULL 表 示 服 务 器 没有 发 
送 有 效 的 Content-Type: header 


3 [E] f 


如 果 opt 被 设置 ， 以 字符 串 形 式 返 回 它 的 值 。 否 则 ， 返 回 返回 一 个 包含 下 列 元 素 的 关联 数组 
(它们 分 别 对 应 于 opt): 


e "url" 

e "content type" 

e "http code" 

e "header size" 

e "request size" 

e "filetime" 

e "ssl verify result" 

e "redirect count" 

e "total time" 

e "namelookup time" 

e "connect time" 

e "pretransfer time" 

e "size upload" 

e "size download" 

e "speed download" 

e "speed upload" 

e "download content length" 
e "upload content length" 
e "starttransfer time" 

e "redirect time" 


更 新 日 志 


版 本 说 明 


5.1.3 引 人 CURLINFO HEADER OUT . 


<?php 
// 创建 一 个 cURL 句 柄 
$ch = curl init("http://www.yahoo.com/"): 


// 执行 
curl exec($ch), 


// 检查 是 否 有 错误 发 生 
if(!curl_errno($ch) ) 


$info = curl getinfo($ch); 


echo 'Took "| . $info['total_time'] . ' seconds to send a request to ' . $info['url']; 


J 


// Close handle 
curl close($ch), 
?> 


PHP curl initEZX 


(PHP 4 >= 4.0.2, PHP 5) 


curl init 一 初始 化 一 个 cURL 会 话 
说 明 
resource curl init ([ string $url = NULL ] ) 


初始 化 一 个 新 的 会 话 ， 返 回 一 个 cURL 句 柄 ， 供 curl_setopt(), curl_exec()#lcurl_close() 函数 
使 用 。 


参数 


url 


如 果 提 供 了 该 参数 ，CURLOPT_URL 选项 将 会 被 设置 成 这 个 值 。 你 也 可 以 使 用 curl_setopt() 
函数 手动 地 设置 这 个 值 。 


返回 值 


如 果 成 功 ， 返 回 一 个 cURL 和 句柄， 出错 返回 FALSE, 


实例 
初始 化 一 个 新 的 cURL 会 话 并 获取 一 个 网 页 


<?php 
// 创建 一 个 新 CURL 资 源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 
curl setopt($ch, CURLOPT URL, "http://www.w3cschool.cc/"); 
curl setopt($ch, CURLOPT HEADER, 0), 


// 抓 取 URL 并 把 它 传递 给 浏览 器 
curl exec($ch), 


// 关闭 cURL 资 源 ， 并 且 释放 系统 资源 
curl close($ch); 
?» 


PHP curl multi add handle 


(PHP 5) 


curl multi add handle 一 向 curl 批 处 理会 话 中 添加 单独 的 curl 句 柄 
说 明 
int curl multi add handle ( resource $mh , resource $ch ) 


增加 ch 句柄 到 批 处 理会 话 mh 


参数 


mh 
由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
ch 


由 curl. init() 返回 的 cURL 句柄 。 


3 [B] f 


成 功 时 返回 0， 失 败 时 返回 CURLM_XXX 之 一 的 错误 码 。 


实例 


这 个 范例 将 会 创建 2 个 cURL 句 柄 ， 把 它们 加 到 批 处 理 句 柄 ， 然 后 并 行 地 运行 它们 。 


<?php 

// 创建 一 对 cURL 资源 
$ch1 = curl init(); 
$ch2 - curl init(); 


// 设置 URL 和 相应 的 选项 

curl setopt($ch1i, CURLOPT URL, "http://www.w3cschool.cc/"); 
curl setopt($ch1i, CURLOPT HEADER, 0); 

curl setopt($ch2, CURLOPT URL, "http://www.php.net/"); 

curl setopt($ch2, CURLOPT HEADER, 0); 


// 创建 批 处 理 CURL 句 柄 
$mh = curl multi init(), 


// 增加 2 个 句柄 
curl multi add handle($mh, $ch1); 
curl multi add handle($mh, $ch2), 


$running-null; 
// 执行 批 处 理 句 柄 
do ( 
curl multi exec($mh, $running); 
+ while($running > 0); 


// 关闭 全 部 句柄 

curl multi remove handle($mh, $ch1), 
curl multi remove handle($mh, $ch2); 
curl multi close($mh); 

?> 








PHP curl multi closerx2K 


(PHP 5) 


curl multi close 一 关闭 一 组 CURL 句 柄 
说 明 
void curl multi close ( resource $mh ) 


关闭 一 组 CURL 句 柄 。 


参数 


mh 


由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
ix [n] 46 
没有 返回 值 。 


实例 


这 个 范例 将 会 创建 2 个 cURL 句 柄 ， 把 它们 加 到 批 处 理 句 柄 ， 然 后 并 行 地 运行 它们 。 


<?php 

// 创建 一 对 cURL 资源 
$ch1 = curl init(); 
$ch2 - curl init(); 


// 设置 URL 和 相应 的 选项 

curl setopt($ch1i, CURLOPT URL, "http://www.example.com/"); 
curl setopt($ch1i, CURLOPT HEADER, 0); 

curl setopt($ch2, CURLOPT URL, "http://www.php.net/"); 
curl setopt($ch2, CURLOPT HEADER, 0); 


// 创建 批 处 理 CURL 句 柄 
$mh = curl multi init(), 


// 增加 2 个 句柄 
curl multi add handle($mh, $ch1); 
curl multi add handle($mh, $ch2), 


$running-null; 
// 执行 批 处 理 句 柄 
do ( 
curl multi exec($mh, $running); 
+ while ($running > 0), 


// 关闭 全 部 句柄 

curl multi remove handle($mh, $ch1), 
curl multi remove handle($mh, $ch2); 
curl multi close($mh); 








?> 


PHP curl_multi_execE 2% 
(PHP 5) 
curl multi exec 一 运行 当前 CURL 句柄 的 子 连 接 
说 明 
int curl multi exec ( resource $mh , int &$still running ) 


处 理 在 栈 中 的 每 一 个 句柄 。 无 论 该 句柄 需要 读 取 或 写 人 数据 都 可 调用 此 方法 。 


参数 


mh 
由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
still_running 


一 个 用 来 判断 操作 是 否 仍 在 执行 的 标识 的 引用 。 


jx [n] 46 
一 个 定义 于 CURL 预定 义 常量 中 的 cURL 代码 。 


注意 : 该 加 数 仅 返回 关于 整个 批 处 理 栈 相关 的 错误 。 即 使 返回 CURLM_OK 时 单个 传输 仍 可 
能 有 问题 。 


实例 


这 个 范例 将 会 创建 2 个 cURL 句柄 ， 把 它们 加 到 批 外 理 句柄 ， 然 后 并 行 地 运行 它们 。 


<?php 

// 创建 一 对 cURL 资源 
$chi = curl init(); 
$ch2 - curl init(); 


// 设置 URL 和 相应 的 选项 

curl setopt($ch1i, CURLOPT URL, "http://1xr.php.net/"); 
curl setopt($ch1i, CURLOPT HEADER, 0); 

curl setopt($ch2, CURLOPT URL, "http://www.php.net/"); 
curl setopt($ch2, CURLOPT HEADER, 0); 


// 创建 批 处 理 CURL 句 柄 
$mh = curl multi init(), 


// 增加 2 个 句柄 
curl multi add handle($mh, $ch1) ; 
curl multi add handle($mh, $ch2), 


$active - null; 
// 执行 批 处 理 句 柄 
do { 
$mrc - curl multi exec($mh, $active); 
+ while ($mrc == CURLM CALL MULTI PERFORM); 


while ($active && $mrc == CURLM OK) { 
if (curl multi select($mh) != -1) { 
do { 
$mrc = curl multi exec($mh, $active); 
+ while ($mrc == CURLM CALL MULTI PERFORM); 


} 
// 关闭 全 部 句柄 


curl multi remove handle($mh, $ch1), 
curl multi remove handle($mh, $ch2); 
curl multi close($mh); 








?> 


PHP curl multi getcontentiiž% 


(PHP 5) 


curl multi getcontent 一 如 果 设 置 了 CURLOPT_RETURNTRANSFER， 则 返回 获取 的 输出 的 
文本 流 


说 明 
string curl multi getcontent ( resource $ch ) 


HIŠRCURLOPT RETURNTRANSFER/F 4 — DR HARI BEI—-T SAND, BL DEIA 
将 会 以 字符 串 的 形式 返回 那个 cURL 句柄 获取 的 内 容 。 


参数 


mh 


由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
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如 果 设 置 了 CURLOPT_RETURNTRANSFER， 则 返回 获取 的 输出 的 文本 流 。 


PHP curl multi info read 


(PHP 5) 
curl multi info read 一 获取 当前 解析 的 cURL 的 相关 传输 信息 


说 明 
array curl multi info read ( resource $mh [, int &$msgs in queue = NULL ] ) 
查询 批 处 理 句柄 是 否 单独 的 传输 线程 中 有 消息 或 信息 返回 。 消 息 可 能 包含 诸如 从 单独 的 传输 


线程 返回 的 错误 码 或 者 只 是 传输 线程 有 没有 完成 之 类 的 报告 。 


ERA TRIK, sh kla 回 一 个 新 的 结果 ， 直 到 这 时 没有 更 多 信息 返回 时 ，FALSE 
被 当 作 一 个 信号 返回 。 通 过 msgs_in_queue 返 回 的 整数 指出 将 会 包含 当 这 次 函数 被 调用 后 ， 
还 剩余 的 消息 数 。 


注意 : 返回 的 资源 指向 的 数据 调用 curl_multi_remove_handle() 后 将 不 会 存在 。 


参数 

mh 

由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
msgs_in_queue 


仍 在 队列 中 的 消息 数量 。 


j& [n] f& 


成 功 时 返回 相关 信息 的 数组 ， 失 败 时 返回 FALSE。 
返回 值 内 容 (返回 数组 的 内 容 ) 


键 值 
msg CURLMSG DONE 常量 。 其 他 返回 值 当 前 不 可 用 。 
result cURLE_* 常量 之 一 。 如 果 一 切 操作 没有 问题 ， 将 会 返回 cuRLE_ok 常量 。 


handle cURL 资源 类 型 表明 它 有 关 的 句柄 。 


zl 


将 


<?php 


$urls = array( 
"http://www.baidu.com/", 
"http://www.google.com.hk/", 
"http://www.w3cschool.cc/" 


); 
$mh = curl_multi_init(); 


foreach ($urls as $i => $url) { 
$conn[$i] = curl init($url), 
curl_setopt($conn[$i], CURLOPT_RETURNTRANSFER, 1); 
curl_multi_add_handle($mh, $conn[$i]); 


} 
do { 
$status - curl multi exec($mh, $active), 
$info = curl multi info read($mh), 
if (false !== $info) { 
var dump($info), 
+ while ($status === CURLM CALL MULTI PERFORM || $active); 


foreach ($urls as $i => $url) { 
$res[$i] = curl multi getcontent($conn[$i]); 
curl close(S$conn[$i]); 


J 
var dump(curl multi info read($mh)); 


2» 


以 上 例 程 的 输出 类 似 于 : 


array(3) { 
["msg"]=> 
int(1) 
["result"]=> 
int(0) 
["handle"]-» 
resource(5) of type (curl) 


} 
array(3) { 
["msg"]=> 
int(1) 
["result"]=> 
int(0) 
["handle"]-» 
resource(7) of type (curl) 


J 
array(3) { 
[ "msg" ]-> 
int(1) 
[ "result"]-> 
int(0) 
["handle"]-» 
resource(6) of type (curl) 


J 
bool(false) 


S ST H 


版 本 说 明 
5.2.0 msgs in queue 被 加 入 。 


PHP curl multi init 


(PHP 5) 


curl multi init — 3&[m] — "3T CURL SIE x E ^3] NA 
说 明 
resource curl multi init ( void ) 


jb VET 13 Hb jo TEE A 3SCURL EIA, 


参数 


此 函数 没有 参数 。 


3 [B] f 


成 功 时 返回 一 个 cURL 批 处 理 句 柄 ， 失 败 时 返回 FALSE。 


实例 


这 个 范例 将 会 创建 2 个 cURL 句 柄 ， 把 它们 加 到 批 处 理 句 柄 ， 然 后 并 行 地 运行 它们 。 


<?php 

// 创建 一 对 cURL 资源 
$chi = curl init(); 
$ch2 - curl init(); 


// 设置 URL 和 相应 的 选项 

curl setopt($ch1i, CURLOPT URL, "http://www.example.com/"); 
curl setopt($ch1i, CURLOPT HEADER, 0); 

curl setopt($ch2, CURLOPT URL, "http://www.php.net/"); 
curl setopt($ch2, CURLOPT HEADER, 0); 


// 创建 批 处 理 CURL 句 柄 
$mh = curl multi init(), 


// 增加 2 个 句柄 
curl multi add handle($mh, $ch1) ; 
curl multi add handle($mh, $ch2), 


$running-null; 
// 执行 批 处 理 句 柄 
do ( 
usleep(10000); 
curl multi exec($mh, $running); 
+ while ($running > 0), 


// 关闭 全 部 句柄 

curl multi remove handle($mh, $ch1), 
curl multi remove handle($mh, $ch2); 
curl multi close($mh); 








?> 


PHP curl multi remove handler2X 


(PHP 5) 


curl multi remove handle 一 移 除 curl 批 处 理 句柄 资源 中 的 某 个 句柄 资源 
说 明 


int curl multi remove handle ( resource $mh , resource $ch ) 





从 给 定 的 批 处 理 句 柄 mh 中 移 除 ch 句柄 。 当 ch 句柄 被 移 除 以 后 ， 仍 然 可 以 合法 地 用 curl_exec() 
执行 这 个 句柄 。 当 正在 移 除 的 句柄 正在 被 使 用 ， 在 处 理 的 过 程 中 所 有 的 传输 任务 会 被 终止 。 


参数 


mh 
由 curl. multi init() 返回 的 cURL 多 个 句柄 。 
ch 


由 curl. init() 返回 的 CURL 句柄 。 


返回 值 


成 功 时 返回 一 个 cURL 名 柄 ， 失 败 时 返回 FALSE。 


PHP curl multi selectEX 2X 
(PHP 5) 
curl multi select 一 等待 所 有 cURL 批 处 理 中 的 活动 连接 
说 明 
int curl multi select ( resource $mh [, float $timeout = 1.0 ] ) 


阻塞 直到 cURL 批 处 理 连 接 中 有 活动 连接 。 


参数 

mh 

由 curl. multi init() 返回 的 CURL 多 个 句柄 。 
timeout 


以 秒 为 单位 ， 等 待 响应 的 时 间 。 


返回 值 


成 功 时 返回 描述 符 集 合 中 描述 符 的 数量 。 失 败 时 ，select 失 败 时 返回 -1， 否 则 返回 超时 (从 底层 
的 select 系 统 调 用 ). 


PHP curl multi setoptiižť 


(PHP 5 >- 5.5.0) 


curl multi setopt 一 设置 一 个 批 处 理 cURL 传 输 选项 。 


说 明 


bool curl multi setopt ( resource $mh , int $option , mixed $value ) 


LIE — TH RIE CURL ££ 48 3 Mo 


需要 设置 的 CURLOPT _XXX 选 项。 
value 


将 设置 在 option 选 项 上 的 值 。 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 bool 类 型 的 值 : 


选项 


CURLOPT_AUTOREFERER 


CURLOPT BINARYTRANSFER 


CURLOPT COOKIESESSION 


CURLOPT CRLF 


CURLOPT DNS USE GLOBAL CACHE 


FJ st value4à 


当 根 据 Location: 重 定向 时 ， 自 动 设置 header! 
Referer: 信 息 。 


TE FAICURLOPT RETURNTRANSFERÉY H 
返回 原生 的 (Raw) 输出 。 


启用 时 curl 会 仅仅 传递 一 个 session cookie, ; 
他 的 cookie， 默 认 状 况 下 cURL 会 特 所 有 的 co 
回 给 服务 端 。session cookie 是 指 那些 用 来 沼 
务 器 端的 session 是 否 有 效 而 存在 的 cookie。 
启用 时 将 Unix 的 换行 符 转 换 成 回 车 换行 符 。 


启用 时 会 启用 一 个 全 局 的 DNS 缓存 ， 此 项 为 ; 
HM, JERSIUA 6 FH, 


显示 HTTP 状 态 码 ， 默 认 行 为 是 忽略 编号 小 于 


CURLOPT FAILONERROR 


CURLOPT FILETIME 


CURLOPT FOLLOWLOCATION 


CURLOPT FORBID REUSE 
CURLOPT FRESH CONNECT 


CURLOPT FTP USE EPRT 


CURLOPT FTP USE EPSV 


CURLOPT FTPAPPEND 
CURLOPT FTPASCII 
CURLOPT FTPLISTONLY 
CURLOPT HEADER 


CURLINFO HEADER OUT 


CURLOPT HTTPGET 


CURLOPT HTTPPROXYTUNNEL 


CURLOPT MUTE 


CURLOPT NETRC 


CURLOPT NOBODY 


CURLOPT NOPROGRESS 


CURLOPT NOSIGNAL 


CURLOPT POST 


400 的 HTTP 信 息 。 


启用 时 会 尝试 修 改 远程 文档 中 的 信息 。 结 果 1 
1 it curlgetinfo()ES2XB3 CURLINFO FILETi 
项 返回 。 curl getinfo(). 


BFA SSR 4 28 A 4 259 EIA) "Location: "T 
header 中 递 为 的 返回 给 服务 器 ， 使 

用 CURLOPT_MAXREDIRS 可 以 限定 递归 返 
数量 。 

在 完成 交互 以 后 强迫 断 开 连接 ， 不 能 重用 。 

强制 获取 一 个 新 的 连接 ， 蔡 代 缓 存 中 的 连接 。 


启用 时 当 FTP 下 载 时 ， 使 用 EPRT (或 LPRT) 
设 证 为 FALSE 时 禁用 EPRT 和 LPRT， 使 用 PC 
倒 only. 


启用 时 ， 在 FTP 传 输 过 程 中 回复 到 PASV 模 式 
尝试 EPSV 命 令 。 设 置 为 FALSE 时 禁用 EP:! 


Bo 

启用 时 追加 宇和 文件 而 不 是 覆盖 它 。 
CURLOPT TRANSFERTEXT 的 别名 。 
启用 时 只 列 出 FTP 目 录 的 名 字 。 
启用 时 会 业 头 文件 的 信息 作为 数据 流 输出 。 


时 追踪 句柄 的 请 求 字符 串 。 


启用 时 会 设置 HTTP 的 method 为 GET， 因 为 ( 
默认 是 ， 所 以 只 在 被 修改 的 情况 下 使 用 。 


启用 时 会 通过 HTTP 代 理 来 传输 。 


启用 时 将 cURL 画 数 中 所 有 修改 过 的 参数 恢复 
值 。 


在 连接 建立 以 后 ， 访 问 <var 
class="filename">~/.netrc</var> 文 件 获取 用 . 


密码 信息 连接 远 元 程 站 点 Wo 
启用 时 将 不 对 HTML 中 的 BODY 部 分 进行 输出 


启用 时 关闭 curl 传 输 的 进度 条 ， 此 项 的 默认 设 
BA Note: PHP 自 动 地 设置 这 个 选项 为 TRI 
这 个 选项 仅仅 应 当 在 以 调试 为 目的 时 被 改变 。 


启用 时 忽略 所 有 的 curl 传 递 给 php 进 行 的 信和 号， 
SAPI 多 线程 传输 时 此 项 被 默认 启用 。 


启用 时 会 发 送 一 个 常规 的 POST 请 求 ， 类 型 
为 : application/x-www-form-urlencoded, 5) 


CURLOPT PUT 


CURLOPT RETURNTRANSFER 


CURLOPT SSL VERIFYPEER 


CURLOPT TRANSFERTEXT 


CURLOPT UNRESTRICTED AUTH 


CURLOPT UPLOAD 


CURLOPT VERBOSE 


3 [E] f 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


单 提交 的 一 样 。 


启用 时 允许 HTTP 发 送 文件 ， 必 须 同时 设 
i&CURLOPT INFILEŽICURLOPT INFILES 


将 curl_exec() 获 取 的 信息 以 文件 流 的 形式 返 [ 
不 是 直接 输出 。 


禁用 后 cURL 将 终止 从 服务 端 进 行 验证 。 使 
用 CURLOPT_CAINFO 选 项 设置 证 书 使 

用 CURLOPT_CAPATH 选 项 设置 证 书目 录 A 
CURLOPT SSL_VERIFYPEER( 默 认 值 为 2) 
用 ，CURLOPT_SSL _VERIFYHOST 需 要 被 
成 TRUE 否则 设置 为 FALSE。 


启用 后 对 FTP 传 输 使 用 ASCII 模 式 。 对 于 LDA 
检索 纯 文本 信息 而 非 HTML。 在 Windows 系 乡 
系统 不 会 把 STDOUT 设 置 成 binary 模 式 。 


TI FHCURLOPT FOLLOWLOCATION = 4 
header HAY Z “locations RE ZB A PÁ 
信息 ， 即 使 域名 已 发 生 改 变 。 


启用 后 允许 文件 上 传 。 


启用 时 会 汇报 所 有 的 信息 ， 存 放 在 STDERR: 
的 CURLOPT_STDERR 中 。 


PHP curl multi strerrorEAžk 


(PHP 5 >= 5.5.0) 


curl multi setopt 一 返回 描述 错误 码 的 字符 串 文 本 。 
说 明 
string curl multi strerror ( int $errornum ) 


返回 描述 CURLM 错误 码 的 字符 串 文 本 。 


errornum 


一 个 ? CURLM error codes 错 误 码 常量 。 


返回 值 


返回 描述 错误 码 的 字符 串 文 本 , 否则 返回 NULL. 


实例 


<?php 

// 创建 CURL 句柄 

$ch1 = curl init("http://www.w3cschool.cc/"); 
$ch2 curl init("http://php.net/"); 


// AE — T Hb A XS CURL AI 
$mh = curl multi init(); 


// 添加 句柄 到 批 处 理 句柄 
curl multi add handle($mh, $ch1), 
curl multi add handle($mh, $ch2); 


// PATH RE AJ NA 
do { 
$status = curl_multi_exec($mh, $active); 
// 检查 错误 
if($status > 0) ( 
// 显示 错误 信息 
echo "ERROR!NN " . curl multi strerror($status), 


} 
} while ($status === CURLM CALL MULTI PERFORM || $active); 
?> 


W3School PHP 参考 手册 
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PHP curl pausebE2X 
(PHP 5 »- 5.5.0) 

curl pause — 暂停 及 恢复 连接 。 

说 明 


int curl pause ( resource $ch , int $bitmask ) 


ch 
由 curl. init() 返回 的 CURL 句柄 。 
bitmask 


CURLPAUSE * 中 的 一 个 常量 。 


返回 值 


返回 一 个 错误 代码 ， 如 果 没 有 错误 返回 CURLE OK, 


PHP curl_reseti 2 


(PHP 5 >= 5.5.0) 


curl_reset— 重 置 libcurl 会 话 句 柄 的 所 有 选项 。 
说 明 
void curl reset ( resource $ch ) 


该 函数 将 重新 初始 化 cCURL 的 所 有 选项 值 (默认 值 ) 。 


注意 : curl. reset() 同样 会 重新 设置 curl. init() 的 URL 参数 。 


ch 


由 curl init() 返回 的 CURL 句柄 。 


3 [B] (A 


没有 返回 值 。 


实例 


<?php 
// 创建 一 个 cURL 句 柄 
$ch = curl init(); 


// 设置 CURLOPT USERAGENT 选项 
curl setopt($ch, CURLOPT USERAGENT, "My test user-agent"), 


// 重 置 所 有 先前 设置 的 选项 
curl reset($ch), 


// 发 送 HTTP 请 求 
curl setopt($ch, CURLOPT URL, 'http://w3cschool.cc/'); 
curl exec($ch); // the previously set user-agent will be not sent, it has been reset by c 


// 关闭 句柄 
curl close($ch), 
?> 











PHP curl setopt arrayBAžk 
(PHP 5 >= 5.1.3) 
curl setopt array 一 为 CURL 传 输 会 话 批量 设置 选项 。 
说 明 
bool curl setopt array ( resource $ch , array $options ) 


ACURL#MBitCHSKREAR BABA TR EREABEBIURLÚU EEA, A 
需要 重复 地 调用 curl _setopt()。 


参数 

ch 

由 curl init() 返回 的 CURL 句柄 。 
options 


一 个 array 用 来 确定 将 被 设置 的 选项 及 其 值 。 数 组 的 键 值 必须 是 一 个 有 效 的 curl_setopt() 常 量 或 
者 是 它们 对 等 的 整数 值 。 


jx [n] f& 


如 果 全 部 的 选项 都 被 成 功 设置 ， 返 回 TRUE。 INEO E 马上 返回 
FALSE， 忽 略 其 后 的 任何 在 options 数 组 中 的 选 


实例 


初始 化 一 个 新 的 cURL 辉煌 并 抓 取 一 个 web 页 面 。 


<?php 
// 创建 一 个 新 CURL 资 源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 


$options = array(CURLOPT URL => 'http://www.w3cschool.cc/', 
CURLOPT HEADER => false 


) ; 
curl setopt array($ch, $options), 


// 抓 取 URL 并 把 它 传递 给 浏览 器 
curl exec($ch), 


// 关闭 CURL 资 源 ， 并 且 释 放 系 统 资源 
curl close($ch); 
?> 


早 于 PHP 5.1.3 这 个 函数 可 以 做 如 下 模拟 : 
我 们 对 curl_setopt_array() 的 等 价 实现 


<?php 
if (!function exists('curl setopt array")) { 
function curl setopt array(&$ch, $curl options) 


foreach ($curl options as $option => $value) { 


if (!curl setopt($ch, $option, $value)) £ 
return false; 
} 
} 


return true, 


注意 : 就 curl_setopt() 来 说 ， 传 递 一 个 数组 到 CURLOPT_POST 将 会 把 数据 以 multipart/form- 
data 的 方式 编码 ， 然 而 传递 一 个 URL-encoded 字 符 串 将 会 以 application/x-www-form- 
urlencoded 的 方式 对 数据 进行 编码 。 


PHP curl_setopt 2 


(PHP 4 >= 4.0.2, PHP 5) 


curl_setopt 一 设置 一 个 cURL 传输 选项 。 


说 明 


bool curl setopt ( resource $ch , int $option , mixed $value ) 


为 给 定 的 CURL 会 话 句柄 设置 一 个 选项 。 


需要 设置 的 CURLOPT _XXX 选 项。 
value 


将 设置 在 option 选 项 上 的 值 。 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 bool 类 型 的 值 : 


选项 


CURLOPT_AUTOREFERER 


CURLOPT BINARYTRANSFER 


CURLOPT COOKIESESSION 


CURLOPT CRLF 


CURLOPT DNS USE GLOBAL CACHE 


CURLOPT FAILONERROR 


FJ st value4à 


当 根 据 Location: 重 定向 时 ， 自 动 设置 header! 
Referer: 信 息 。 


TE FAICURLOPT RETURNTRANSFERÉY H 
返回 原生 的 (Raw) 输出 。 


启用 时 curl 会 仅仅 传递 一 个 session cookie, ; 
他 的 cookie， 默 认 状 况 下 cURL 会 特 所 有 的 co 
回 给 服务 端 。session cookie 是 指 那些 用 来 沼 
务 器 端的 session 是 否 有 效 而 存在 的 cookie。 
启用 时 将 Unix 的 换行 符 转 换 成 回 车 换行 符 。 


启用 时 会 启用 一 个 全 局 的 DNS 缓存 ， 此 项 为 ; 
HM, JERSIUA 6 FH, 


显示 HTTP 状 态 码 ， 默 认 行 为 是 忽略 编号 小 于 


CURLOPT FAILONERROR 


CURLOPT FILETIME 


CURLOPT FOLLOWLOCATION 


CURLOPT FORBID REUSE 
CURLOPT FRESH CONNECT 


CURLOPT FTP USE EPRT 


CURLOPT FTP USE EPSV 


CURLOPT FTPAPPEND 
CURLOPT FTPASCII 
CURLOPT FTPLISTONLY 
CURLOPT HEADER 


CURLINFO HEADER OUT 


CURLOPT HTTPGET 


CURLOPT HTTPPROXYTUNNEL 


CURLOPT MUTE 


CURLOPT NETRC 


CURLOPT NOBODY 


CURLOPT NOPROGRESS 


CURLOPT NOSIGNAL 


400 的 HTTP 信 息 。 


启用 时 会 尝试 修 改 远程 文档 中 的 信息 。 结 果 1 
1 it curlgetinfo()ES2XB3 CURLINFO FILETi 
项 返回 。 curl_getinfo(). 


启用 时 会 将 服务 器 服务 器 返回 的 "Location: "I 
header 中 递 为 的 返回 给 服务 器 ， 使 

用 CURLOPT_MAXREDIRS 可 以 限定 北 为 返 
在 完成 交互 以 后 强迫 断 开 连接 ， 不 能 重用 。 
强制 获取 一 个 新 的 连接 ， 蔡 代 缓 存 中 的 连接 。 


启用 时 当 FTP 下 载 时 ， 使 用 EPRT (或 LPRT) 
设置 为 FALSE 时 禁用 FEPRT 和 LPRT， 使 用 PC 
倒 only. 


启用 时 ， 在 FTP 传 输 过 程 中 回复 到 PASV 模 式 
党 试 EPSV 命 令 。 设 置 为 FALSE 时 禁用 EP! 


Bo 

启用 时 追加 宇和 文件 而 不 是 覆盖 它 。 
CURLOPT TRANSFERTEXT 的 别名 。 
启用 时 只 列 出 FTP 目 录 的 名 字 。 
启用 时 会 将 头 文件 的 信息 作为 数据 流 输 出 。 


时 追踪 句柄 的 请 求 字符 串 。 


启用 时 会 设置 HTTP 的 method 为 GET， 因 为 C 
默认 是 ， 所 以 只 在 被 修改 的 情况 下 使 用 。 


启用 时 会 通过 HTTP 代 理 来 传输 。 


启用 时 将 cURL 画 数 中 所 有 修改 过 的 参数 恢复 
值 。 


在 连接 建立 以 后 ， 访 问 <var 
class-"filename"»-/.netrc«/var» X (t 3& RA, 
密码 信息 连接 远 元 程 站 点 "o 


启用 时 将 不 对 HTML 中 的 BODY 部 分 进行 输出 


启用 时 关闭 curl 传 输 的 进度 条 ， 此 项 的 默认 设 
AH. Note: PHP 自 动 地 设置 这 个 选项 为 TRI 
这 个 选项 仅仅 应 当 在 以 调试 为 目的 时 被 改变 。 


启用 时 忽略 所 有 的 curl 传 递 给 php 进 行 的 信号 ， 
SAPI 多 线程 传输 时 此 项 被 默认 启用 。 


启用 时 会 一 个 常规 的 POST 请 求 ， 类 型 


CURLOPT PUT 


CURLOPT RETURNTRANSFER 


CURLOPT SSL VERIFYPEER 


CURLOPT TRANSFERTEXT 


CURLOPT UNRESTRICTED AUTH 


CURLOPT UPLOAD 


CURLOPT VERBOSE 


单 提交 的 一 样 。 


启用 时 人 允许 HTTP 发 送 文 件 ， 必 须 同时 设 
i&CURLOPT INFILEŽICURLOPT INFILES 


将 curl_exec() 获 取 的 信息 以 文件 流 的 形式 返 [ 
不 是 直接 输出 。 


禁用 后 cURL 将 终止 从 服务 端 进 行 验证 。 使 
用 CURLOPT_CAINFO 选 项 设置 证 书 使 

用 CURLOPT_CAPATH 选 项 设置 证 书目 录 HI 
CURLOPT SSL_VERIFYPEER( 默 认 值 为 2) 
FH, CURLOPT _SSL_VERIFYHOST 需 要 被 
成 TRUE 否则 设置 为 FALSE。 


启用 后 对 FTP 传 输 使 用 ASCII 模 式 。 对 于 LDA 
检索 纯 文本 信息 而 非 HTML。 在 Windows 系 乡 
系统 不 会 把 STDOUT 设 置 成 binary 模 式 。 


IŻ FRCURLOPT FOLLOWLOCATION = 4 
header 中 的 多 个 locations 中 持续 追加 用 户 名 
信息 ， 即 使 域名 已 发 生 改 变 。 


启用 后 允许 文件 上 传 。 


启用 时 会 汇报 所 有 的 信息 ， 存 放 在 STDERR: 
的 CURLOPT_STDERR 中 。 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 integer 类 型 的 值 : 


选项 


CURLOPT BUFFERSIZE 


CURLOPT CLOSEPOLICY 


CURLOPT CONNECTTIMEOUT 


CURLOPT CONNECTTIMEOUT MS 


可 选 Value 值 


每 次 获取 的 数据 中 读 入 缓存 的 大 小 ， 但 是 不 保证 
个 值 每 次 都 会 被 填 满 。 


不 是 
CURLCLOSEPOLICY LEAST RECENTLY USI 
就 是 CURLCLOSEPOLICY_OLDEST， 还 存在 另 
— DCURLCLOSEPOLICY, (HA ECURL % sf a T: 
持 。 


在 发 起 连接 前 等 待 的 时 间 ， 如 果 设 置 为 0， 则 无 限 
待 。 


尝试 连接 等 待 的 时 间 ， 以 毫秒 为 单位 。 如 果 设 置 > 
0， 则 无 限 等 待 。 


CURLOPT DNS CACHE TIMEOUT 


CURLOPT FTPSSLAUTH 


CURLOPT HTTP VERSION 


CURLOPT INFILESIZE 


CURLOPT LOW SPEED LIMIT 


CURLOPT LOW SPEED TIME 


CURLOPT MAXCONNECTS 


CURLOPT MAXREDIRS 


CURLOPT PORT 


CURLOPT PROTOCOLS 


置 在 内 存 中 保存 DNS 信息 的 时 间 ， 默 认为 120 


o 


设 
秒 


FTP 验 证 方式 : CURLFTPAUTH SSL (首先 党 试 
SSL), CURLFTPAUTH TLS (首先 尝试 TLS) 
或 CURLFTPAUTH_DEFAULT (让 CURL 自 动 决定 : 


CURL HTTP VERSION NONE (默认 值 ， 让 cUI 
自己 判断 使 用 哪个 版 

Æ), CURL HTTP VERSION 1 O0 (强制 使 用 
HTTP/1.0):%CURL HTTP VERSION 1 1 (强制 
FA HTTP/1.1). 


设 定 上 传 文件 的 大 小 限制 ， 字 节 (byte) 为 单位 。 


当 传输 速度 小 于 CURLOPT_LOW_SPEED_LIMT 
时 (bytes/sec)，PHP 会 根 

据 CURLOPT_LOW_SPEED_TIME 来 判断 是 否 
慢 而 取消 传输 。 


当 传输 速度 小 于 CURLOPT_LOW_SPEED_LIMT 
时 (bytes/sec)，PHP 会 根 

据 CURLOPT_LOW_SPEED_TIME 来 判断 是 否 
慢 而 取消 传输 。 


允许 的 最 大 连接 数量 ， 超 过 是 会 通过 
CURLOPT_CLOSEPOLICY 决 定 应 该 停止 哪些 连 
接 。 


指定 最 多 的 HTTP 重 定向 的 数量 ， 这 个 选项 是 和 
CURLOPT_FOLLOWLOCATION 一 起 使 用 的 。 


用 来 指定 连接 端口 。 (可 选项 ) 


CURLPROTO_* 的 位 域 指 。 如 果 被 启用 ， 位 域 值 : 
限定 libcurl 在 传输 过 程 中 有 哪些 可 使 用 的 协议 。 这 
允许 你 在 编译 libcurl 时 支持 众多 协议 ， 但 是 限制 只 
用 它们 中 被 允许 使 用 的 一 个 子 集 。 默 认 libcurl 将 会 
用 全 部 它 支持 的 协议 。 参 见 
CURLOPT_REDIR_PROTOCOLS .可 用 的 协议 先 
为 : CURLPROTO HTTP, 

CURLPROTO HTTPS, CURLPROTO FTP, 
CURLPROTO FTPS, CURLPROTO SCP, 
CURLPROTO_SFTP, CURLPROTO TELNET, 
CURLPROTO LDAP, CURLPROTO LDAPS, 
CURLPROTO DICT, CURLPROTO FILE, 
CURLPROTO TFTP, CURLPROTO ALL 


CURLOPT PROTOCOLS 


CURLOPT PROXYAUTH 


CURLOPT PROXYPORT 


CURLOPT PROXYTYPE 


CURLOPT REDIR PROTOCOLS 


CURLOPT RESUME FROM 


CURLOPT SSL VERIFYHOST 


CURLOPT SSLVERSION 


CURLPROTO * 的 位 域 指 。 如 果 被 启用 ， 位 域 值 : 
限定 libcurl 在 传输 过 程 中 有 哪些 可 使 用 的 协议 。 这 
允许 你 在 编译 libcurl 时 支持 众多 协议 ， 但 是 限制 只 
用 它们 中 被 允许 使 用 的 一 个 子 集 。 默 认 libcurl 将 会 
用 全 部 它 支 持 的 协议 。 参 见 
CURLOPT_REDIR_PROTOCOLS. 可 用 的 协议 选 
为 : CURLPROTO HTTP, 

CURLPROTO HTTPS, CURLPROTO FTP, 
CURLPROTO FTPS, CURLPROTO SCP, 
CURLPROTO SFTP, CURLPROTO TELNET, 
CURLPROTO LDAP, CURLPROTO LDAPS, 
CURLPROTO DICT, CURLPROTO FILE, 
CURLPROTO TFTP, CURLPROTO ALL 


HTTP 代 理 连接 的 验证 方式 。 使 用 
在 CURLOPT_HTTPAUTH 中 的 位 域 标 志 来 设置 杠 
应 选项 。 对 于 代理 验证 只 有 CURLAUTH_BASICf 
CURLAUTH_NTLM 当 前 被 支持 。 


代理 服务 器 的 端口 。 端 口 也 可 以 
在 CURLOPT_PROXY 中 进行 设置 。 


不 是 CURLPROXY_HTTP (默认 值 ) 就 
是 CURLPROXY SOCKS5。 


CURLPROTO * 中 的 位 域 值 。 如 果 被 启用 ， 位 域 . 
将 会 限制 传输 线程 

TECURLOPT FOLLOWLOCATIONT £ i1 RES 5 
PEREGO EF RÁSŤ SERM 
制 传输 线程 使 用 被 允许 的 协议 子 集 默 认 libcurl 将 会 
许 除 FILE 和 SCP 之 外 的 全 部 协议 。 这 个 和 7.19.4 也 
发 布 版 本 种 无 条 件 地 跟随 所 有 支持 的 协议 有 一 些 7 
同 。 关 于 协议 常量 ， 请 参 

照 CURLOPT_PROTOCOLS。 


在 恢复 传输 时 传递 一 个 字 节 偏 移 量 (用 来 断 点 续 
f). 


1 检查 服务 器 SSL 证 书 中 是 否 存在 一 个 公用 名 
(common name)。 译 者 注 : 公用 名 (Common 
Name) 一 般 来 讲 就 是 填写 你 将 要 申请 SSL 证 书 的 二 
名 (domain) 或 子 域名 (sub domain)。2 检查 公用 和 
是 否 存在 ， 并 且 是 否 与 提供 的 主机 名 匹配 。 


使 用 的 SSL 版 本 (2 或 3)。 默 认 情 况 下 PHP 会 自己 : 
测 这 个 值 ， 尽 管 有 些 情况 下 需要 手动 地 进行 设置 。 


如 果 在 CURLOPT_TIMEVALUE 指 定 的 某 个 时 间 1 
后 被 编辑 过 ， 则 使 


CURLOPT TIMECONDITION 


CURLOPT TIMEOUT 


CURLOPT TIMEOUT MS 


CURLOPT TIMEVALUE 


FACURL TIMECOND IFMODSINCE? [Bl 5i M, 
果 没有 被 修改 过 ， 并 且 CURLOPT_HEADER 为 
true， 则 返回 一 个 "304 Not Modifieq" 的 header， 
CURLOPT_HEADER 为 false， 则 使 

FACURL TIMECOND IFUNMODSINCE, EN. fi 
3X CURL. TIMECOND IFUNMODSINCE, 


设置 cURL 人 允许 执行 的 最 长 秒 数 。 


设置 cURL 人 允许 执行 的 最 长 毫秒 数 。 


设置 一 个 CURLOPT_TIMECONDITION 使 用 的 时 
戳 ， 在 黑 认 状态 下 使 用 的 
是 CURL TIMECOND IFMODSINCE, 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 string 类 型 的 值 : 


选项 


CURLOPT_CAINFO 


CURLOPT_CAPATH 


CURLOPT_COOKIE 


CURLOPT_COOKIEFILE 


CURLOPT_COOKIEJAR 


CURLOPT_CUSTOMREQUEST 


可 选 Value 值 


一 个 保存 着 1 个 或 多 个 用 来 让 服务 端 验证 的 证 书 的 
文件 名 。 这 个 参数 仅仅 在 和 
CURLOPT SSL_VERIFYPEER 一 起 使 用 时 才 有 


mm. 
Lo 


一 个 保存 着 多 个 CA 证 书 的 目录 。 这 个 选项 是 和 
CURLOPT SSL_VERIFYPEER 一 起 使 用 的 。 


设 定 HTTP 请 求 中 "Cookie: "部 分 的 内 容 。 多 个 
cookie 用 分 号 分 隔 ， 分 号 后 带 一 个 空格 (例如 ， 
"fruitzapple, colourzreď“), 


包含 cookie 数 据 的 文件 名 ，cookie 文 件 的 格式 可 
以 是 Netscape 格 式 ， 或 者 只 是 纯 HTTP 头 部 信息 
存 入 文件 。 


连接 结束 后 保存 cookie 信 息 的 文件 。 


使 用 一 个 自 定义 的 请 求 信息 来 代 

替 "GET' 或 "HEAD" 作 为 HTTP 请 求 。 这 对 于 执 

行 "DELETE" 或 者 其 他 更 隐 敬 的 HTTP 请 求 。 有 效 
值 如 "GET"”， "POST", "CONNECT' 等 等 。 也 就 
是 说 ， 不 要 在 这 里 输入 整个 HTTP 请 求 。 例 如 输 
A "GET /index.html HTTP/1.0\rin\rin" 是 不 正确 
BY. Note: 在 确定 服务 器 支持 这 个 自 定义 请 求 的 


CURLOPT EGDSOCKET 


CURLOPT ENCODING 


CURLOPT FTPPORT 


CURLOPT INTERFACE 


CURLOPT KRB4LEVEL 


CURLOPT POSTFIELDS 


CURLOPT PROXY 
CURLOPT PROXYUSERPWD 


CURLOPT RANDOM FILE 


CURLOPT RANGE 


CURLOPT REFERER 
CURLOPT SSL CIPHER LIST 


CURLOPT SSLCERT 
CURLOPT SSLCERTPASSWD 


方法 前 不 要 使 用 。 


类 似 CURLOPT_RANDOM_FILE， 除 了 一 个 
Entropy Gathering Daemon 套 接 字 。 


HTTP 请 求 关 中 "Accept-Encoding: "的 值 。 支 持 的 
4 5373 "identity", "deflate"fü"gzip", 如 果 为 空 字 
符 串 ”"， 请 求 头 会 发 送 所 有 支持 的 编码 类 型 。 


这 个 值 将 被 用 来 获取 供 FTP"POST" 指 邻 所 需要 的 
IP 地 址 。"POST" 指 使 告诉 远程 服务 器 连接 到 我 们 
指定 的 IP 地 址 。 这 个 字符 串 可 以 是 纯 文 本 的 IP 地 
址 、 主 机 名 、 一 个 网 络 接口 名 (UNIX 下 ) 或 者 只 
是 一 个 '-' 来 使 用 默认 的 IP 地 址 。 


网 络 发 送 接口 名 ， 可 以 是 一 个 接口 名 、IP 地 址 或 
者 是 一 个 主机 名 。 


KRB4 (Kerberos 4) 安全 级 别 。 下 面 的 任何 值 都 
是 有 效 的 (从 低 到 高 的 顺 

FF): "clear", "safe", "confidential", "private".. 
如 果 字 符 串 和 这 些 都 不 匹配 ， 将 使 用 "private"。 
这 个 选项 设置 为 NULL 时 将 禁用 KRB4 安全 认证 。 
目前 KRB4 安全 认证 只 能 用 于 FTP 传 输 。 


全 部 数据 使 用 HTTP 协 议 中 的 "POST" 操 作 来 发 
送 。 要 发 送 文 件 ， 在 文件 名 前 面 加 上 @ 前 级 并 使 
用 完整 路 径 。 这 个 参数 可 以 通过 urlencoded 后 的 
字符 串 类 似 'para1=val/1&para2=val2&...' 或 使 用 一 
个 以 字段 名 为 键 值 ， 字 段 数据 为 值 的 数组 。 如 果 
value 是 一 个 数组 ，ContentType 头 将 会 被 设置 
py. multipart/form-data, 


HTTP 代 理 通道 。 


一 个 用 来 连接 到 代理 的 "[username]: 
[password] "R RAFE. 


一 个 被 用 来 生成 SSL 随 机 数 种 子 的 文件 名 。 

以 "xc-Y" 的 形式 ， 其 中 X 和 Y 都 是 可 选项 获取 数据 
的 范围 ， 以 字 节 计 。HTTP 传 输 线 程 也 支持 几 个 
这 样 的 重复 项 中 间 用 逗号 分 隔 如 "X-YN-M"。 

在 HTTP 请 求 关 中 "Referer: "的 内 容 。 


一 个 SSL 的 加 密 算法 列表 。 例 如 RC4-SHA 和 
TLSv1 都 是 可 用 的 加 密 列 表 。 


一 个 包含 PEM 格 式 证 书 的 文件 名 。 
使 用 CURLOPT_SSLCERT 证 书 需 要 的 密码 。 


证 书 的 类 型 。 支 持 的 格式 有 "PEM" (默认 值 )， 


CURLOPT_SSLCERTTYPE "DERVENG", 


用 来 在 CURLOPT_SSLKEY 中 指定 的 SSL 私 钥 的 
加 密 引 擎 变量 。 


CURLOPT SSLENGINE DEFAULT ”用 来 做 非 对 称 加 密 操 作 的 变量 。 


CURLOPT_SSLENGINE 


CURLOPT_SSLKEY 包含 SSL 私 钥 的 文件 名 。 
在 CURLOPT_SSLKEY 中 指定 了 的 SSL 私 钥 的 密 
CURLOPT SSLKEYPASSWD 5, Note: 由 于 这 个 选项 包含 了 敏感 的 密码 信 


息 ， 记 得 保证 这 个 PHP 脚 本 的 安全 。 


CURLOPT _SSLKEY 中 规定 的 私 钥 的 加 密 类 型 ， 
CURLOPT SSLKEYTYPE 支持 的 密 钥 类 型 为 "PEM"( 默 认 
值 )、"DER"f0"ENG"。 


需要 获取 的 URL 地 址 ， 也 可 以 在 curl_init() 画 数 中 
zE, 
在 HTTP 请 求 中 包含 一 个 "User-Agent: " 头 的 字符 


o 


传递 一 个 连接 中 需要 的 用 户 名 和 密码 ， 格 式 为 :" 


[username]:[password]". 


CURLOPT_URL 


CURLOPT_USERAGENT 


CURLOPT_USERPWD 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 数组 : 


选项 可 选 Value 值 备注 
在 
CURLOPT HTTP200ALIASES ，200 响 应 码 数组 ， 数 组 中 的 响应 吗 被 认为 A. 
ei 是 正确 的 响应 ， 否 则 被 认为 是 错误 的 。 ert 
中 被 加 
入 。 


一 个 用 来 设置 HTTP 头 字段 的 数组 。 使 用 如 
下 的 形式 的 数组 进行 设置 : 

array( Content-type: text/plain', Content- 
length: 100") 


在 FTP 请 求 执行 完成 后 ， 在 服务 器 上 执行 
的 一 组 FTP 命 今 。 


一 组 先 于 FTP 请 求 的 在 服务 器 上 执行 的 


FIPS. 


CURLOPT_HTTPHEADER 


CURLOPT_POSTQUOTE 
CURLOPT_QUOTE 


对 于 下 面 的 这 些 option 的 可 选 参数 ，value 应 该 被 设置 一 个 流 资源 (例如 使 用 fopen()) 


选项 


CURLOPT FILE 


可 选 Value 值 


设置 输出 文件 的 位 置 ， 值 是 一 个 资源 类 型 ， 默 认 
为 STDOUT (浏览 器 )。 


CURLOPT INFILE 在 上 传 文件 的 时 候 需 要 读 取 的 文件 地 址 ， 值 是 一 个 资源 
设置 一 个 错误 输出 地 址 ， 值 是 一 个 资源 类 型 ， 取 代 默 认 

CURLOPT STDERR #STDERR, 

CURLOPT WRITEHEADER 设置 header 部 分 内 容 的 写 入 的 文件 地 址 ， 值 是 一 个 资源 


对 于 下 面 的 这 些 option 的 可 选 人 参数，value 应 该 被 设置 为 一 个 回调 图 数 名 : 


选项 


CURLOPT_HEADERFUNCTION 


CURLOPT PASSWDFUNCTION 


CURLOPT PROGRESSFUNCTION 


CURLOPT READFUNCTION 


CURLOPT WRITEFUNCTION 


TRIE) f 


Fy xt value4à 


AE — TEAK, ix ENTAUB DAZU #— 
个 是 cURL 的 资源 句柄 ， 第 二 个 是 输出 的 header 
数据 。header 数 据 的 输出 必须 依赖 这 个 函数 ， 返 
回 已 写 入 的 数据 大 小 。 


设置 一 个 回调 男 数 ， 有 三 个 参数 ， 第 一 个 是 
cURL 的 资源 句柄 ， 第 二 个 是 一 个 密码 提示 符 ， 
第 三 个 参数 是 密码 长 度 人 允许 的 最 大 值 。 返 回 密码 
的 值 。 


设置 一 个 回调 函数 ， 有 三 个 参数 ， 第 一 个 是 
cURL 的 资源 句柄 ， 第 二 个 是 一 个 文件 描述 符 资 
源 ， 第 三 个 是 长 度 。 返 回 包含 的 数据 。 


回调 函数 名 。 该 本 数 应 接受 三 个 参数 。 第 一 个 是 
CURL resource ; 第 二 个 是 通过 选项 

CURLOPT INFILE 传 给 cURL 的 stream 
resource ; 第 三 个 参数 是 最 大 可 以 读 取 的 数据 的 
数量 。 回 调 函 数 必须 返回 一 个 字符 串 ， 长 度 小 
于 或 等 于 请 求 的 数据 量 (第 三 个 参数 ) 。 一 般 从 
传 入 的 stream resource 读 取 。 返 回 空 字符 串 作 
为 EOF (文件 结束 ) 信号 。 


回调 函数 名 。 该 范 数 应 接受 两 个 参数 。 第 一 个 是 
CURL resource ; 第 二 个 是 要 写 入 的 数据 字符 
cB, AX 据 必 须 在 函数 中 被 保存 。 画 数 必须 返回 
准确 的 传人 的 要 写 入 数据 的 字 节 数 ， 否 则 传输 会 
被 一 个 错误 所 中 断 。 


成 功 时 返回 TRUE, 或 者 在 失败 时 返回 FALSE, 


更 新 日 志 


版 本 说 明 
5.2.10 SIA cURLOPT PROTOCOLS , ANd CURLOPT REDIR PROTOCOLS . 


5.1.0 引入 CURLOPT AUTOREFERER , CURLOPT BINARYTRANSFER , CURLOPT FTPSSLAUTH 
Me CURLOPT PROXYAUTH , and CURLOPT_TIMECONDITION 


引入 CURLOPT FTP USE EPRT , CURLOPT NOSIGNAL , CURLOPT UNRESTRICTED AUTH 
5.0.0 CURLOPT BUFFERSIZE , CURLOPT HTTPAUTH , CURLOPT PROXYPORT 
CURLOPT PROXYTYPE , CURLOPT SSLCERTTYPE , and CURLOPT HTTP200ALIASES 


实例 


初始 化 一 个 新 的 cURL 会 话 并 获取 一 个 网 页 


Ma 


«?php 
// 创建 一 个 新 CURL 资 源 
$ch = curl init(), 


// 设置 URL 和 相应 的 选项 


curl setopt($ch, CURLOPT URL, "http://www.example.com/"); 
curl setopt($ch, CURLOPT HEADER, false), 


// 抓 取 URL 并 把 它 传递 给 浏览 器 
curl exec($ch), 


// 关 闭 CURL 资 源 ， 并 且 释放 系 统 资 源 


curl close($ch), 
?> 


上 传 文件 实例 : 


<?php 

/* http://localhost/upload. php: 

print r($ POST), 

print r($ FILES), 

a 

$ch - curl init(); 

$data = array('name' => "Foo", "file" => 'Q/home/user/test.png'); 
curl setopt($ch, CURLOPT URL, 'http://localhost/upload.php'); 
curl setopt($ch, CURLOPT POST, 1); 

curl setopt($ch, CURLOPT POSTFIELDS, $data); 


curl exec($ch), 
?> 


以 上 实例 输出 结果 如 下 : 


[name] -» Foo 


[file] -» Array 


[name] -» test.png 

[type] => image/png 
[tmp_name] => /tmp/phpcpjNeQ 
[error] => 0 

[size] => 279 


传递 一 个 数组 到 CURLOPT_POSTFIELDS，cURL 会 把 数据 编码 成 multipart/form-data, mA 
传递 一 个 URL-encoded 字 符 串 时 ， 数 据 会 被 编码 成 application/x-www-form-urlencoded。 


PHP curl share closež% 


(PHP 5 >= 5.5.0) 


curl share close 一 关闭 cURL 共享 句柄 
说 明 
void curl share close ( resource $sh ) 


关闭 cURL 共享 句柄 并 释放 所 有 资源 。 


参数 


sh 


通过 curl_share_init() 返 回 cURL 共 享 句柄 。 
jx [n] f 
没有 返回 值 。 


实例 


该 实例 将 创建 一 个 cCURL 共 享 句 柄 ， 并 添加 两 个 cURL 句柄 ， 两 个 句柄 共享 cookie 数 据 。 


<?php 

// 创建 CURL 共 享 句柄 并 设置 cookie 数 据 

$sh = curl share init(), 

curl share setopt($sh, CURLSHOPT SHARE, CURL LOCK DATA COOKIE), 


// 初始 化 第 一 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch1 = curl init("http://www.w3cschool.cc/"); 
curl setopt($ch1i, CURLOPT SHARE, $sh), 


// 执行 第 一 个 cURL 句 柄 
curl exec($ch1); 


// 初始 化 第 二 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch2 = curl init("http://php.net/"); 
curl setopt($ch2, CURLOPT SHARE, $sh), 


// 执行 第 二 个 cURL 句 柄 
// FRA $ch1 句柄 的 数据 在 $ch2 句柄 中 共享 


curl exec($ch2); 


// 关闭 cURL 共 享 句柄 
curl share close($sh); 


// KRACURLA 
curl close($ch1), 
curl close($ch2), 
?> 


PHP curl share inité/žk 


(PHP 5 >= 5.5.0) 


curl share init 一 初始 化 一 个 CURL 共享 句柄 
说 明 
resource curl share init ( void ) 


允许 两 个 CURL 句柄 分 享 数据 。 


参数 
此 西数 没有 参数 。 


返回 值 


返回 "cURL 共享 句柄 "的 资源 。 


实例 


该 实例 将 创建 一 个 cURL 共享 句柄 ， 并 添加 两 个 cURL 句柄 ， 两 个 句柄 共享 cookie 数 据 。 


<?php 

// 创建 CURL 共 享 句柄 并 设置 cookie 数 据 

$sh = curl share init(), 

curl share setopt($sh, CURLSHOPT SHARE, CURL LOCK DATA COOKIE), 


// 初始 化 第 一 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch1 = curl init("http://www.w3cschool.cc/"); 
curl setopt($ch1i, CURLOPT SHARE, $sh), 


// 执行 第 一 个 cURL 句 柄 
curl exec($ch1); 


// 初始 化 第 二 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch2 = curl init("http://php.net/"); 
curl setopt($ch2, CURLOPT SHARE, $sh), 


// 执行 第 二 个 cURL 句 柄 
// FRA $ch1 句柄 的 数据 在 $ch2 句柄 中 共享 


curl exec($ch2); 


// 关闭 cURL 共 享 句柄 
curl share close($sh); 


// KRACURLA 
curl close($ch1), 
curl close($ch2), 
?> 


PHP curl share setoptiižť 


(PHP 5 >= 5.5.0) 


curl share setopt 一 设置 cURL 共享 句柄 的 一 个 选项 。 
说 明 
bool curl share setopt ( resource $sh , int $option , string $value ) 


设置 CURL 共享 句柄 的 一 个 选项 。 


参数 


sh 


S 


通过 curl share init() 初始 化 的 共享 句柄 。 


option 
CURLSHOPT SHARE 指定 共享 的 数据 类 型 
CURLSHOPT_UNSHARE 指定 不 共享 的 数据 类 型 
value 
值 描述 
CURL LOCK DATA COOKIE 共享 cookie 数 据 
CURL LOCK DATA DNS 共享 DNS 缓存 。 


共享 SSL session ID, 减少 连接 到 相同 的 服务 器 花费 在 
SSL 握手 时 的 时 间 。 


CURL LOCK DATA SSL SESSION 





j& [n] f& 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


实例 


该 实例 将 创建 一 个 cCURL 共 享 句 柄 ， 并 添加 两 个 CURL 句柄 ， 两 个 句柄 共享 cookie 数 据 。 


<?php 

// 创建 CURL 共 享 句柄 并 设置 cookie 数 据 

$sh = curl share init(); 

curl share setopt($sh, CURLSHOPT SHARE, CURL LOCK DATA COOKIE); 


// 初始 化 第 一 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch1 = curl init("http://www.w3cschool.cc/"); 
curl setopt($chi1, CURLOPT SHARE, $sh), 


// 执行 第 一 个 cURL 句 柄 
curl exec($ch1); 


// 初始 化 第 二 个 cURL 句 柄 并 指定 它 为 共享 句柄 
$ch2 = curl init("http://php.net/"); 
curl setopt($ch2, CURLOPT SHARE, $sh), 


// 执行 第 二 个 cURL 句 柄 
// 所 有 $chi 句柄 的 数据 在 $ch2 句柄 中 共享 


curl exec($ch2); 


// 关闭 cURL 共 享 句柄 
curl share close($sh); 


// KRACURLAJ 
curl close($ch1), 
curl close($ch2), 
?> 


PHP curl strerrorikižk 


(PHP 5 >= 5.5.0) 


curl strerror 一 返回 错误 码 的 描述 。 
说 明 
string curl strerror ( int $errornum ) 


错误 码 的 文本 描述 信息 


errornum 


一 个 ? cURL 错误 码 的 常量 。 


3 [E f 


回 错误 码 描述 术 信息 ， 非法 错 错误 码 返回 NULL 。 


实例 


<?php 
// 创建 一 个 拼写 错误 的 URL 的 CURL 句 柄 
$ch = curl init("htp://example.com/"); 


// 发 送 请 求 
curl exec($ch), 


// 检查 错误 代码 并 显示 错误 信息 
if($errno = curl errno($ch)) { 
$error message - curl strerror($errno), 
echo "CURL error ({$errno}):\n {$error_message}"; 


} 
// 关闭 句柄 


curl close($ch), 
?> 


以 上 例 程 会 输出 : 


W3School PHP 参考 手册 


CURL error (1): 
Unsupported protocol 


PHP curl strerrorEq2X 221 


PHP curl unescapeišižk 


(PHP 5 >= 5.5.0) 


curl unescape 一 解码 经 过 URL 编 码 的 字符 串 。 
说 明 
string curl unescape ( resource $ch , string $str ) 


解码 经 过 URL 编 码 的 字符 串 。 


注意 : curl unescape() 不 能 解码 加 号 (+) 为 空格 , urldecode() 可 以 。 


ch 
由 curl. init() 返回 的 cURL 句柄 。 
str 


URL 编码 的 字符 串 


3 [B] f 


返回 解码 字符 串 或 者 在 失败 时 返回 FALSE, 


例 


将 


<?php 
// 创建 一 个 cur1 句 柄 
$ch = curl init('http://example.com/redirect.php'); 


// 发 送 HTTP 请 求 
curl setopt($ch, CURLOPT FOLLOWLOCATION, 1), 
curl exec($ch), 


// 获得 最 后 一 个 有 效 的 URL 
$effective url = curl getinfo($ch, CURLINFO EFFECTIVE URL); 
// ie. "http://example.com/show location.php?loc-M%C3%BCnchen" 


// 解码 URL 
$effective url decoded = curl unescape($ch, $effective url); 
// "http://example.com/show location.php?loczMünchen" 


// 关闭 句柄 
curl close($ch), 
?> 


PHP curl_versioni2 


(PHP 5 >= 5.5.0) 


curl version 一 获取 cURL 版 本 信息 。 
说 明 
array curl version ([ int $age = CURLVERSION NOW ] ) 


返回 关于 cURL 的 版 本 信息 。 


返回 值 


返回 一 个 相关 的 数组 包含 如 下 元 素 : 


Indice 值 描述 
version_number CURL 24 位 版 本 号 
version cURL 版 本 号 ， 字 符 串 形式 
ssl version number OpenSSL 24 位 版 本 号 
ssl version OpenSSL 版 本 号 ， 字 符 串 形式 
libz_version zlib 版 本 号 ， 字 符 串 形式 
host 关于 编译 cURL 主机 的 信息 
age 
features 一 个 CURL_VERSION_XXX 常 量 的 位 掩 码 
protocols 一 个 cURL 支持 的 协议 名 字 的 数组 


例 


将 


个 范例 将 会 检查 当前 cURL 版 本 使 用 curl_version() 返 回 的 'features' 位 掩 码 中 哪些 特性 是 可 用 


o 


ix 
B5 


«?php 
// 获取 cURL 版 本 数组 


$version = curl version(); 


// 在 cURL 编译 版 本 中 使 用 位 域 来 检查 某 些 特性 
$bitfields = Array( 
"CURL VERSION IPV6', 
'CURL VERSION KERBEROS4', 
'CURL VERSION SSL', 
'CURL VERSION LIBZ' 


); 


foreach($bitfields as $feature) 


{ 
echo $feature . ($version['features'] 8 constant($feature) ? ' matches' : ' does not 
echo PHP EOL, 

J 

?> 





PHP Date / Time EZ 


PHP Date / Time 简介 


date/time 函数 允许 您 提取 并 格式 化 服务 器 上 的 日 期 和 时 间 。 


注释 : 这 些 函 数 依赖 于 服务 器 的 本 地 设置 。 


ro yt 
安装 


date/time 函数 是 PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 函 数 。 


Runtime 配置 


日 期 /时 间 画 数 的 行为 受到 php.ini 中 设置 的 影响 。 


Date/Time 配置 选项 : 


名 称 


date.default latitude 


date.default longitude 


date.sunrise zenith 


date.sunset zenith 


date.timezone 


默认 


"31.7667" 


"35.2333" 


"90.83" 


"90.83" 


PHP Date / Time EAžk 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


描述 


规定 默认 纬度 (M PHP 5 开始 
可 用 ) o date_sunrise() 和 
date sunset() 使 用 该 选项 。 


规定 默认 经 度 (从 PHP 5 开始 
可 用 ) o date_sunrise() 和 
date_sunset() 使 用 该 选项 。 


规定 日 出 天 项 (M PHP 5 开始 
可 用 ) o date_sunrise() 和 
date sunset() 使 用 该 选项 。 


规定 日 落 天 项 (M PHP 5 开始 
可 用 ) o date_sunrise() 和 
date sunset() 使 用 该 选项 。 


规定 默认 时 区 (M PHP 5.1 开 
台 可 用 ) o 


可 改变 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 


EA 描述 PHP 


checkdate() 验证 格 利 高 里 日 期 。 3 
date_default_timezone_get() ”返回 默认 时 区 。 5 
date default timezone set() ”设置 默认 时 区 。 5 
date sunrise() 返回 给 定 的 日 期 与 地 点 的 日 出 时 间 。 5 
date sunset() 返回 给 定 的 日 期 与 地 点 的 日 落 时 间 。 5 
date() MNA A H je] OR B 
getdate() 返回 日 期 时 间 信 息 。 3 
gettimeofday() 返回 当前 时 间 信 息 。 3 
gmdate() 格式 化 GMT/UTC 日 期 /时 间 。 3 
gmmktime() 取得 GMT 日 期 的 UNIX s4 ja] S. 3 
gmstrftime() RA GMT/UTC & ig “ H 3 
idate() 将 本 地 时 间 / 日 期 格式 化 为 整 关 5 
localtime() 返回 本 地 时 间 。 4 
microtime() 返回 当前 时 间 的 微 秒 数 。 3 
mktime() 返回 一 个 日 期 的 Unix at H BX 3 
strftime() AR HE PR RIE TR C tb u je] / BBB. B 
strptime() 解析 由 strftime 生成 的 日 期 时间。 5 
O) A 日 期 或 时 间 描 述 解析 为 Unix 3 
time() 返回 当前 时 间 的 Unix et je] Bx. 3 


PHP Date / Time 常量 
的 P 


PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 


常量 
DATE_ATOM 
DATE_COOKIE 
DATE 1808601 
DATE RFC822 
DATE RFC850 
DATE RFC1036 
DATE RFC1123 
DATE RFC2822 
DATE RSS 


DATE W3C 


描述 PHP 
原子 钟 格式 (如 : 2005-08-15T16:13:03+0000) 
HTTP Cookies 格式 (如 : Sun, 14 Aug 2005 16:13:03 UTC) 
ISO-8601 (40: 2005-08-14T16:13:03+0000) 
RFC 822 (40: Sun, 14 Aug 2005 16:13:03 UTC) 
RFC 850 (40: Sunday, 14-Aug-05 16:13:03 UTC) 
RFC 1036 (40: Sunday, 14-Aug-05 16:13:03 UTC) 
RFC 1123 (40: Sun, 14 Aug 2005 16:13:03 UTC) 
RFC 2822 (40: Sun, 14 Aug 2005 16:13:03 +0000) 
RSS (40: Sun, 14 Aug 2005 16:13:03 UTC) 


World Wide Web Consortium (如 : 2005-08- 
14T16:13:03+0000) 


PHP checkdate() 函数 


= ~ ~ 

定义 和 用 法 

checkdate() 汞 数 验证 一 个 格 里 高 里 日 期 。 

如 果 指 定 的 值 合法 ， 则 该 图 数 返回 true, ENIE false. 
日 期 在 下 列 情况 下 为 合法 : 


e month 介 于 且 包 括 1 - 12 


e Day 的 值 在 给 定 的 month 所 应 该 具有 的 天 数 范 围 之 内 ， 半 年 已 经 考虑 


。 year 介 于 且 包 括 1 到 32767 
语法 


checkdate(month, day, year) 


参数 描述 
month 必需 。 规 定 月 。 
day 必需 。 规 定 日 。 
year 必需 。 规 定年 。 


例子 


<?php 

var dump(checkdate(12, 31, 2000)), 
var dump(checkdate(2,29,2003)); 
var dump(checkdate(2,29,2004)); 
?> 


输出 : 


bool(true) 
bool(false) 
bool(true) 


PHP date default timezone get() 函数 


= ~ M 
date default timezone get() WUR [el TZ PAT EJ RB at i] ESAT FI BIA BY CS 
语法 


date default timezone get(void) 


参数 描述 
void 可 选 。 


说 明 
本 豆 数 返回 默认 时 区 ， 使 用 如 下 “假定 ”的 顺序 : 


e 用 date_default_timezone_set() HAZ ERIN RK (如 果 设 定 了 的 话 ) 
。 TZ 环境 变量 〈 如 果 非 空 ) 

e date.timezone 配置 选项 (如 果 设 定 了 的 话 ) 

。 自己 推测 (如 果 操 作 系统 支持 ) 

。 如 果 以 上 选择 都 不 成 功 ， 则 返回 UTC 


例子 


<?php 
echo(date default timezone get()), 
?> 


输出 : 


Europe/Paris 


PHP date default timezone set() 2 
定义 和 用 法 

date default timezone set() 函数 设置 用 在 脚本 中 所 有 日 期 /时 间 函 数 的 默认 时 区 。 
语法 


date default timezone set(timezone) 


参数 描述 
timezone 必需 。 时 区 标识 符 ， 比 如 "UTC" 或 "Europe/Paris"。 合 法 时 区 的 列 
R : http://www.php.net/manual/en/timezones.php 
说 明 


注释 : 自 PHP 5.1.0 起 (此 版 本 日 期 时 间 画 数 被 重 写 了 ) ， 如 果 时 区 不 合法 则 每 个 对 日 期 时 
i] ES ZB 38 FH AER E NOTICE 级 别 的 错误 信息 ， 如 果 使 用 系统 设 定 或 TZ 环境 变量 
则 还 会 产生 E_STRICT 级 别 的 信息 。 


例子 


<?ph 
echo(date default timezone set("Europe/Paris")), 
?> 


输出 : 


PHP date sunrise() 函数 
定义 和 用 法 

date sunrise() 函数 返回 指定 的 日 期 与 地 点 的 日 出 时 间 。 
语法 


date sunrise(timestamp, format, latitude, longitude, zenith, gmt offset) 


参数 描述 
timestamp ”必需 。 
可 选 。 规 定 如 何 返 回 结果 :  SUNFUNCS RET STRING (以 string 格式 返回 结 
OA 果 ， 上 比如 16:46) SUNFUNCS RET DOUBLE (以 float 格式 返回 结果 ， 上 比如 
16.78243132) suNFUNCS_RET_TIMESTAMP (以 integer 格式 (ay jg] Ek). 返回 结 
果 ， 上 比如 1095034606) 
; 可 选 。 规 定 地 点 的 纬度 。 默 认 是 指 北纬 。 因 此 如 果 要 指定 南 纬 ， 必 须 传 递 
latitude 一 个 负 什 
人 o 
可 选 。 规 定 地 点 的 经 度 。 默 认 是 指示 经 。 因 此 如 果 要 指定 西 经 ， 必 须 传 递 
longitude SU 
人 o 
zenith 可 选 。 


gmt offset Jit, ME GMT 与 本 地 时 间 的 差 值 。 单 位 是 小 时 。 


例子 


<?php 

// 计 算 和 葡萄牙 里 斯 本 的 日 出 时 间 

//Latitude: 北纬 38.4 Æ 

//Longitude: #9 JE 

//Zenith ~= 90 

//offset: +1 GMT 

echo("Date: " . date("D M d Y") . "<br />"); 

echo("Sunrise time: "); 

echo(date sunrise(time(),SUNFUNCS RET STRING, 38.4, -9,90,1)); 
?> 


输出 : 


Date: Tue Jan 24 2006 
Sunrise time: 08:52 
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PHP date sunrise() 函数 239 


PHP date sunset() i 
To 3 
date sunset() 函数 返回 指定 的 日 期 与 地 点 的 日 落 时 间 。 
语法 
date sunset(timestamp, format, latitude, longitude, zenith, gmt offset) 


参数 描述 
timestamp ”必需 。 


可 选 。 规 定 如 何 返 回 结果 : SUNFUNCS_RET_STRING (以 string 格式 返回 结 
果 ， 上 比如 16:46) SUNFUNCS RET DOUBLE (以 float 格式 返回 结果 ， 比 如 


tornat 16.78243132) SUNFUNCS RET TIMESTAMP (以 integer 格式 (ad HA) 返回 结 
果 ， 比 如 1095034606) 
lati 可 选 。 规 定 地 点 的 纬度 。 默 认 是 指 北纬 。 因 此 如 果 要 指定 南 纬 ， 必 须 传 递 
atitude 一 个 负 什 
A o 
可 选 。 规 定 地 点 的 经 度 。 默 认 是 指示 经 。 因 此 如 果 要 指定 西 经 ， 必 须 传 递 
longitude 个 负 值 
A o 
zenith 可 选 。 


gmt offset Jit, ME GMT 与 本 地 时 间 的 差 值 。 单 位 是 小 时 。 


例子 


<?php 

/7 计算 葡萄 牙 里 斯 本 的 日 出 时 间 

//Latitude: 北纬 38.4 度 

//Longitude: 西 经 9 度 

//Zenith ~= 90 

//offset: *1 GMT 

echo("Date: " . date("D M d Y") . "<br />"); 

echo("Sunrise time: "); 

echo(date sunset(time(),SUNFUNCS RET STRING, 38.4, -9,90,1)); 
?> 


输出 : 


Date: Tue Jan 24 2006 
Sunrise time: 18:44 
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PHP date sunset() HŽ 241 


PHP date() 函数 


定义 和 用 法 
date() 画 数 格式 化 一 个 本 地 时 间 一 日 期 。 
语法 


date(format, timestamp) 


参数 描述 
format V 


T 
timestamp 可 选 。 


例子 


<?php 

echo("Result with date():«br /»"); 

echo(date("1") . "«br /»"); 

echo(date("1 dS Nof F Y h:i:s A") . "<br />"); 

echo("Oct 3,1975 was on a ".date("1", mktime(0,0,0,10,3,1975))."«br /»"); 
echo(date(DATE RFC822) . "<br /»"); 

echo(date(DATE ATOM,mktime(0,0,0,10,3,1975)) . "«br /»«br /»"); 


echo("Result with gmdate():«br /»"); 

echo(gmdate("1") . "<br /»"); 

echo(gmdate("1 dS Nof FY h:i:s A") . "<br /»"); 

echo("Oct 3,1975 was on a ".gmdate("1", mktime(0,0,0,10,3,1975))."«br /»"); 
echo(gmdate(DATE RFC822) . "«br /»"); 

echo(gmdate(DATE ATOM,mktime(0,0,0,10,3,1975)) . "«br /»"); 

?> 


输出 : 


Result with date(): 

Tuesday 

Tuesday 24th of January 2006 02:41:22 PM 
Oct 3,1975 was on a Friday 

Tue, 24 Jan 2006 14:41:22 CET 
1975-10-03T00:00:00+0100 


Result with gmdate(): 

Tuesday 

Tuesday 24th of January 2006 01:41:22 PM 
Oct 3,1975 was on a Thursday 

Tue, 24 Jan 2006 13:41:22 GMT 
1975-10-02T23:00:00+0000 
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PHP date() 函数 243 


PHP getdate() HŽ% 
定义 和 用 法 
getdate() HA 48 AH at WES. 
语法 

getdate(timestamp) 


参数 描述 
timestamp 可 选 。 规 定 Unix 时 间 格 式 中 的 时 间 。 
说 明 


返回 一 个 根据 timestamp 得 出 的 包含 有 日 期 信息 的 结合 数组 。 如 果 没 有 给 出 时 间 惟 ， 则 认为 
是 当前 本 地 时 间 。 


数组 中 的 单元 如 下 : 
键 名 说 明 返回 值 例 子 
"seconds" — 秒 的 数字 表示 0 到 59 
"minutes" 分 钟 的 数字 表示 0 到 59 
"hours" 小 时 的 数字 表示 0 到 23 
"mday" 月 份 中 第 几 天 的 数字 表示 1 到 31 
"wday” ”星期 中 第 几 天 的 数字 表示 2 NE NET 
"mon" 月 份 的 数字 表示 1 到 12 
"year" 4 位 数字 表示 的 完整 年 份 例如 : 1999 或 2003 
"yday" 一 年 中 第 几 天 的 数字 表示 0 到 365 
"weekday" — 星期 几 的 完整 文本 表示 Sunday 到 Saturday 
"month" 月 份 的 完整 文本 表示 January 到 December 


系统 相关 ， 典 型 值 为 从 
-2147483648 到 
2147483647。 


自从 Unix 纪元 开始 至 今 的 秒 数 ， 和 time() 
的 返回 值 以 及 用 于 date() 的 值 类 似 。 


例子 
例子 1 


<?php 
print r(getdate()); 
?> 


输出 : 


Array 

( 

[seconds] -» 45 
[minutes] -» 52 
[hours] -» 14 
[mday] -» 24 
[wday] => 2 

[mon] => 1 

[year] -» 2006 
[yday] -» 23 
[weekday] -» Tuesday 
[month] => January 
[0] => 1138110765 


) 


例子 2 


<?php 

$my t-getdate(date("U")); 

print ("$my t[weekday], $my t[month] $my t[mday], $my t[year]"); 
?> 


输出 : 


Wednesday, January 25, 2006 


PHP gettimeofday() E25 


= ~ N 
gettimeofday() HZUREI—T 81 & Sain A A BRA., 


A PHP 5.1.0 起 有 个 可 选 参数 return float, 4A XE 4 TRUE 1+, gettimeofday() 会 返回 一 
个 浮 点 数 。 


所 返回 的 数组 键 的 含义 是 : 
e "sec" - A Unix 纪元 起 的 秒 数 
e "usec" - 微 秒 数 
e "minuteswest" - 格林 威 治 向 西 的 分 钟 数 
e "dsttime" - 夏令 时 修正 的 类 型 
mj 


gettimeofday(return float) 


参数 描述 
return_float 可 选 。 当 其 设置 为 TRUE 时 ，gettimeofday() 会 返回 一 个 浮 点 数 。 


例子 
例子 1 


<?php 

echo(gettimeofday(true) . "<br /><br />"), 
print r(gettimeofday()); 

?> 


输出 : 


1138111447.4 
Array 


[sec] -» 1138111447 
[usec] -» 395863 
[minuteswest] -» -60 
[dsttime] -» 0 

) 


例子 2 


<?php 

$my t-gettimeofday(); 

print("$my t[sec].$my t[usec]"); 
?> 


输出 : 


1138197006.988273 


PHP gmdate() HŽ 


定义 和 用 法 
gmdate() EgZkf& X45, GMT/UTC 日 期 /时 间 。 
Ex 


fa] date() 函数 类 似 ， 不 同 的 是 返回 的 时 间 是 格林 威 治标 准时 (GMT). 
语法 


gmdate(format,timestamp) 


参数 描述 
format 可 选 。 规 定 如 何 返 回 结果 。 
timestamp 可 选 。 
日 二 > + 
提示 和 注释 


注释 : TE PHP 5.1.0 之 前 ， 负 的 时 间 惟 (1970 年 之 前 的 日 期 ) 在 某 些 系统 下 (例如 
Windows) 不 能 工作 。 


例子 
例子 1 


当 在 中 国 (GMT +0800) 运行 以 下 程序 时 ， 第 一 行 显示 “Jan 01 2000 00:00:00”， 而 第 二 行星 
zm Dec 31 1999 16:00:00". 
<?php 


echo date("M d Y 
echo gmdate("M d 
?» 


H:i:s", mktime (0,0,0,1,1,2000)); 
Y H:i:s", mktime (0,0,0,1,1,2000)); 


输出 : 


Jan 01 2000 00:00:00 
Dec 31 1999 16:00:00 


例子 2 


<?php 

echo("Result with date():«br /»"); 

echo(date("1") . "«br /»"); 

echo(date("l dS Nof FY h:i:s A") . "<br />"); 

echo( "Oct 3,1975 was on a ".date("1", mktime(0,0,0,10,3,1975))."«br /»"); 
echo(date(DATE RFC822) . "<br /»"); 

echo(date(DATE ATOM,mktime(0,0,0,10,3,1975)) . "«br /»«br /»"); 


echo("Result with gmdate():«br /»"); 

echo(gmdate("1") . "<br /»"); 

echo(gmdate("1 dS Nof FY h:i:s A") . "<br /»"); 

echo("Oct 3,1975 was on a ".gmdate("1", mktime(0,0,0,10,3,1975))."«br /»"); 
echo(gmdate(DATE RFC822) . "«br /»"); 

echo(gmdate(DATE ATOM,mktime(0,0,0,10,3,1975)) . "«br /»"); 

?> 


输出 : 


Result with date(): 

Tuesday 

Tuesday 24th of January 2006 02:41:22 PM 
Oct 3,1975 was on a Friday 

Tue, 24 Jan 2006 14:41:22 CET 
1975-10-03T00:00:00+0100 


Result with gmdate(): 

Tuesday 

Tuesday 24th of January 2006 01:41:22 PM 
Oct 3,1975 was on a Thursday 

Tue, 24 Jan 2006 13:41:22 GMT 
1975-10-02T23:00:00+0000 


PHP gmmktime() 函数 


rn 、 i 

gmmktime() HA GMT 日 期 的 UNIX st jg Ek. 

与 mktime() 类 似 ， 不 同 的 是 返回 值 是 格林 威 治标 准时 的 时 间 戳 。 

参数 总 是 表示 GMT 日 期 ， 因 此 is dst 对 结果 没有 影响 。 

与 mktime() 一 样 ， 参 数 可 以 从 右 到 左 依次 空 着 ， 空 着 的 参数 会 被 设 为 相应 的 当前 GMT 值 。 
语法 


gmmktime(hour, minute, second, month, day, year, is_dst) 


hour 可 选 。 规 定 小 时 。 
minute — 可 选 。 规 定 分 钟 。 
second Fit, MEM. 


month 可 选 。 规 定 用 数字 表示 的 月 。 
day Hit. MER. 


可 选 。 规 定年 。 在 某 些 系统 上 ， 合 法 值 介 于 1901 - 2038 之 间 。 不 过 在 PHP 5 
中 已 经 不 存在 这 个 限制 了 。 


可 选 。 如 果 时 间 在 日 光 节 约 时 间 (DST) 期 间 ， 则 设置 为 1， 否 则 设置 为 0， 若 未 
is dst 知 ， 则 设置 为 -1。 自 5.1.0 8, is dst BARAR. Alb aaa PA 
理 特 性 。 


year 


提示 和 注释 


注释 : gmmktime() 内 部 使 用 了 mktime()， 因 此 只 有 转换 成 本 地 时 间 也 合法 的 时 间 才 能 用 在 其 
中 。 


例子 


<?php 

$my birthday - gmmktime(0,0,0,10,3,1975); 
print($my birthday . "«br /»"); 
print(date("M-d-Y",$my birthday)); 

?> 


输出 : 


181526400 
Oct-03-1975 


PHP gmstrftime() 2X 

定义 和 用 法 

gmstrftime() 范 数 根据 本 地 区 域 设 置 格式 化 GMT/UTC 时 间 二 日 期 。 
语法 


gmstrftime(format,timestamp) 


参数 描述 
format 可 选 。 规 定 如 何 返 回 结果 。 
timestamp 可 选 。 


提示 和 注释 


提示 : 与 strftime() 的 行为 相同 ， 不 同 的 是 返回 时 间 是 格林 威 治标 准时 (GMT). 


例子 
输出 strftime() 和 gmstrftime() 的 结果 : 


<?php 
echo(strftime("%b %d %Y %X", mktime(20,0,0,12,31,98))); 
echo(gmstrftime( "%b %d %Y %X", mktime(20,0,0,12,31,98))); 


// 输 出 当前 日 期 、 时 间 和 时 区 
echo(gmstrftime("It is %a on %b %d, %Y, %X time zone: %Z",time())); 
?» 


Dec 31 1998 20:00:00 
Dec 31 1998 19:00:00 
It is Wed on Jan 25, 2006, 11:32:10 time zone: W. Europe Standard Time 


PHP idate() 函数 
定义 和 用 法 
idate() 函数 将 本 地 时 间 / 日 期 格式 化 为 整数 。 
语法 

strftime(format,timestamp) 


BR 描述 
format 可 选 。 规 定 如 何 返 回 结果 。 


timestamp 可 选 。 
说 明 
根据 给 定 的 格式 字符 对 timestamp 进行 格式 化 ， 并 返回 数字 结果 。 
timestamp 为 可 选项 ， 默 认 值 为 本 地 当前 时 间 ， 即 time() 的 值 。 
E 一 Mis 
提示 和 EFE 
注释 : 3 date() PIE], idate) 只 接受 一 个 字符 作为 format 参数 。 


format 参数 可 识别 以 下 字符 


format = 


符 


三 | 三 e 


«x 


例子 


<?ph 


Swatch Beat/Internet Time 

月 份 中 的 第 几 天 

小 时 (12 小 时 格式 ) 

小 时 (24 小 时 格式 ) 

分 钟 

如 果 启 用 夏 时 制 则 返回 1， 否 则 返回 0 
如 果 是 兰 年 则 返回 1， 否 则 返回 0 
月 份 的 数字 

秒 数 

本 月 的 总 天 数 


A Unix 纪元 (January 1 1970 00:00:00 GMT) 起 的 秒 数 一 一 这 和 time() 


作用 相同 
星期 中 的 第 几 天 (星期 天 是 0) 


ISO-8601 格式 年 份 中 的 第 几 个 星期 ， 每 星期 从 星期 一 开始 


年 份 (1 或 2 位 数字 一 一 见 下 面 说 明 ) 
年 份 (4 位 数字 ) 

年 份 中 的 第 几 天 

以 秒 为 单位 的 时 区 偏 移 量 


echo(idate("Y")); 
?» 


PHP localtime() 2% 


定义 和 用 法 
localtime() 函数 返回 本 地 时 间 (一 个 数组 ) 。 
localtime() 的 第 一 个 参数 是 时 间 戳 ， 如 果 没 有 给 出 则 使 用 从 time() 返回 的 当前 时 间 。 


第 二 个 参数 是 js_associative， 如 果 设 为 false 或 未 提供 则 返回 的 是 普通 的 数字 索引 数组 。 如 
果 该 参数 设 为 true 则 localtime() 函数 返回 一 个 关联 数组 。 


天 联 数组 中 不 同 的 键 名 是 : 


e "tm sec" - 秒 数 

e "tm min" - 分 钟 数 

e "tm hour" - 小 时 

e "tm mday" - 月 份 中 的 第 几 日 

e "tm mon" - 年 份 中 的 第 几 个 月 ， 从 0 开始 表示 一 月 
e "tm year" - 年 份 ， 从 1900 开始 

e "tm wday" - 星期 中 的 第 几 天 

e "tm yday" - 一 年 中 的 第 几 天 

e "tm isdst" - 夏 合 时 当前 是 否 生效 


注释 : AMMO (一 月 ) 到 11 (十 二 月 ) ， 星 期 数 从 0 (星期 天 ) 到 6 (星期 六 ) 。 
语法 
localtime(timestamp, is associative) 


参数 描述 


eo 、 HAať ad s ++ pix as woe 
timestamp eee 间 。 若 未 规定 timestamp, mfi Fg 3g 


is associative ， 可 选 。 规 定 返回 索引 数组 还 是 关联 数组 。 


例子 


<?php 

$localtime - localtime(), 

$localtime assoc - localtime(time(), true); 
print r($localtime), 

print r($localtime assoc); 

?> 


输出 : 

Array 

( 
[0] => 24 
[1] => 3 
[2] => 19 
[3] => 3 
[4] => 3 
[5] => 105 
[6] => 0 
[7] => 92 
[9] => 1 

) 

Array 


( 

[tm_sec] => 24 
[tm min] => 3 
[tm hour] => 19 
[tm mday] -» 3 
[tm mon] => 3 
[tm year] -» 105 
[tm wday] -» 0 
[tm yday] -» 92 
[tm isdst] => 1 


PHP microtime() 2% 
定义 和 用 法 

microtime() ARE] 44] Unix 时 间 惟 和 微 秒 数 。 
语法 


microtime(get as float) 


del es vet 如 果 给 出 了 get as float 参数 并 且 其 值 等 价 于 TRUE, iz SACRE [B] — 
—— 浮 点 数 。 
说 明 


ABR i TE HE gettimeofday() 系统 调用 的 操作 系统 下 可 用 。 


如 果 调 用 时 不 带 可 选 参 数 ， 本 函数 以 "msec sec" 的 格式 返回 一 个 字符 串 ， 其 中 sec 是 自 Unix 
纪元 (0:00:00 January 1, 1970 GMT) 起 到 现在 的 秒 数 ，msec 是 微 秒 部 分 。 字 符 串 的 两 部 
分 都 是 以 秒 为 单位 返回 的 。 


例子 


<?php 
echo(microtime()); 
?> 


输出 : 


0.25139300 1138197510 


PHP mktime() HŽ% 


mo 、 : 
mktime() 函数 返回 一 个 日 期 的 Unix By ja] i. 
参数 总 是 表示 GMT AH, Bt is dst 对 结果 没有 影响 。 


参数 可 以 从 右 到 左 依次 空 着 ， 空 着 的 参数 会 被 设 为 相应 的 当前 GMT 值 。 
语法 


mktime(hour,minute, second,month, day, year, is_dst) 


参数 描述 
hour 可 选 。 规 定 小 时 。 
minute Fit, WED 
second Fit, WEW. 
month 可 选 。 规 定 用 数字 表示 的 月 。 
day 可 选 。 规 定 天 。 


可 选 。 规 定年 。 在 某 些 系统 上 ， 合 法 值 介 于 1901 - 2038 之 间 。 不 过 在 PHP 5 
中 已 经 不 存在 这 个 限制 了 。 


可 选 。 如 果 时 间 在 日 光 节 约 时 间 (DST) 期 间 ， 则 设置 为 1， 否 则 设置 为 0， 若 未 
is dst 知 ， 则 设置 为 -1。 自 5.1.0 ž8, is dst BARRA. Alt i žE FLA KR 
理 特性 。 


year 


A — ims 
提示 和 ME XE 
注释 : TE PHP 5.1 Za, MRAKA, MARE false, 


例子 


mktime() 辑 数 对 于 日 期 运算 和 验证 非常 有 用 。 它 可 以 自动 校正 越界 的 输入 : 


<?php 

echo(date( "M-d-Y",mktime(0,0,0,12, 36, 2001))), 
echo(date( "M-d-Y",mktime(0,0,0, 14,1, 2001))): 
echo(date("M-d-Y",mktime(0,0,0,1,1,2001))); 
echo(date("M-d-Y",mktime(0,0,0,1,1,99))); 

?» 


输出 : 


Jan-05-2002 
Feb-01-2002 
Jan-01-2001 
Jan-01-1999 


PHP strftime() 2X 
定义 和 用 法 

strftime() 函数 根据 区 域 设置 格式 化 本 地 时 间 玉 日 期 。 
语法 


strftime(format,timestamp) 


参数 描述 
format 可 选 。 规 定 如 何 返 回 结果 。 
timestamp 可 选 。 


提示 和 注释 


提示 : 与 gmstrftime() 的 行为 相同 ， 不 同 的 是 返回 时 间 是 本 地 时 间 。 


例子 
输出 strftime() 和 gmstrftime() 的 结果 : 


<?php 
echo(strftime("%b %d %Y %X", mktime(20,0,0,12,31,98))); 
echo(gmstrftime( "%b %d %Y %X", mktime(20,0,0,12,31,98))); 


// 输 出 当前 日 期 、 时 间 和 时 区 
echo(gmstrftime("It is %a on %b %d, %Y, %X time zone: %Z",time())); 
?» 


Dec 31 1998 20:00:00 
Dec 31 1998 19:00:00 
It is Wed on Jan 25, 2006, 11:32:10 time zone: W. Europe Standard Time 


PHP strptime() 函数 
定义 和 用 法 

strptime() 函数 解析 由 strftime() 生成 的 日 期 了 时间。 
语法 


strptime(date, format) 


参数 描述 
date 要 解析 的 字符 串 (例如 从 strftime() 返回 的 ) 。 


format date 所 使 用 的 格式 (与 strftime() 中 所 使 用 的 相同 ) 。 


说 明 
strptime() 返回 一 个 将 date 解析 后 的 数组 ， 如 果 出 错 返 回 FALSE, 


月 份 和 星期 几 的 名 字 以 及 其 它 和 与 语种 有 关 的 字符 串 对 应 于 setlocale() 设 定 的 当前 区 域 
(LC TIME) 。 


数组 中 包含 以 下 单元 : 
键 名 说 明 

tm_sec 当前 分 钟 内 的 秒 数 (0-61) 
tm min 当前 小 时 内 的 分 钟 数 (0-59) 
tm_hour 午夜 起 的 小 时 数 (0-23) 
tm_mday 月 份 中 的 第 几 天 (1-31) 
tm_mon 自 一 月 起 过 了 几 个 月 (0-11) 
tm_year A 1900 年 起 过 了 几 年 
tm_wday 自 星期 天 起 过 了 几 天 (0-6) 
tm_yday 本 年 自 一 月 一 日 起 过 了 多 少 天 (0-365) 
unparsed date 中 未 能 通过 指定 的 format 识别 的 部 分 


例子 


输出 strftime() 和 strptime() 的 结果 : 


<?php 

$format="%d/%m/%Y 96H :96M :96S" ; 
$strf-strftime($format); 
echo("$strf"); 

print r(strptime($strf,$format)); 
?> 


输出 : 


03/10/2005 13:23:44 
Array 

( 

[tm sec] => 44 
[tm min] -» 23 
[tm hour] -» 13 
[tm mday] -» 3 
[tm mon] -» 9 
[tm year] -» 105 
[tm wday] => 0 
[tm yday] -» 276 
[unparsed] => 


) 


PHP strtotime() 函数 


= ~ N 
strtotime() BABU EA RAXA, A HA sp je] Ha AAT 77 Unix at i] Se 
语法 


strtotime(time, now) 


参数 描述 
time 规定 要 解析 的 时 间 字 符 串 。 
now 用 来 计算 返回 值 的 时 间 戳 。 如 果 省 略 该 参数 ， 则 使 用 当前 时 间 。 


说 明 


该 画 数 预期 接受 一 个 包含 美国 英语 日 期 格式 的 字符 串 并 党 试 将 其 解析 为 Unix tae (A 
s 1 1970 00:00:00 GMT 起 的 秒 数 ) ， 其 值 相 对 于 now 参数 给 出 的 时 间 ， 如 果 没 有 提 
供 此 参数 ， 则 用 系统 当前 时 间 。 


QOS TZ 环境 变量 (如 果 有 的 话 ) 来 计算 时 间 戳 。 自 PHP 5.1.0 起 有 更 容易 的 方法 来 
i AFANANE iJ PA. tbt date default timezone get() 函数 页 面 中 有 
说 明 。 


jx [n] à 
PMID EE] At jg ZB, ARE] FALSE, Œ PHP 5.1.0 之 前 本 函数 在 失败 时 返 


例子 


<?php 

echo(strtotime("now")); 

echo(strtotime("3 October 2005")); 
echo(strtotime("+5 hours")); 

echo(strtotime("+1 week")); 

echo(strtotime("+1 week 3 days 7 hours 5 seconds")); 
echo(strtotime( "next Monday")); 

echo(strtotime( "last Sunday")); 

?» 


输出 : 


1138614504 
1128290400 
1138632504 
1139219304 
1139503709 
1139180400 
1138489200 


PHP time() HŽ% 


定义 和 用 法 


time() 函数 返回 当前 时 间 的 Unix nt ja] 2o 


语法 
time(void) 
参数 描述 
void 可 选 。 
说 明 


返回 自从 Unix 纪元 (格林 威 治 时 间 1970 F 1 A 1H 00:00:00) 到 当前 时 间 的 秒 数 。 


提示 和 注释 


提示 : A PHP 5.1 E $ SERVER['REQUEST. TIME 中 保存 了 发 起 该 请 求 时 刻 的 时 间 惟 。 


例子 
例子 1 


<?php 

$t-time(); 

echo($t . "«br /»"); 
echo(date("D F d Y",$t)); 
?> 


输出 : 


1138618081 
Mon January 30 2006 


例子 2 


<?php 
$nextWeek = time() + (7 * 24 * 60 * 60); // 7 days; 24 hours, 60 mins; 60secs 


echo 'Now: '. date('Y-m-d') ."\n"; 
echo "Next Week: '. date('Y-m-d', $nextWeek) ."\n"; 
?> 
输出 : 
Now: 2005-03-30 


Next Week: 2005-04-07 


PHP Directory 函数 

PHP Directory 简介 

Directory E28 Jb A (3X - EI E GLPALASBAMRS e 

安装 

Directory HLE PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 画 数 。 


PHP Directory ia 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


函数 描述 
chdir() 改变 当前 的 目录 。 
chroot() 改变 当前 进程 的 根 目录 。 
dir() 打开 一 个 目录 句柄 ， 并 返回 一 个 对 象 。 
closedir() 关闭 目录 句柄 。 
getcwd() 返回 当前 目录 。 
opendir() 打开 目录 句柄 。 
readdir() 返回 目录 句柄 中 的 条 目 。 
rewinddir() 重 置 目录 句柄 。 
scandir() 列 出 指定 路 径 中 的 文件 和 目录 。 


PHP Directory 常量 


PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 
常 
DIRECTORY_SEPARATOR 3 
PATH SEPARATOR 4 


tala 
HF 
H 


PHP 


U O U U AA U U A O 


PHP 


PHP chdir() 函数 


= . N 

chdir() 函数 把 当前 的 目录 改变 为 指定 的 目录 。 
若 成 功 ， 则 该 函数 返回 true， 否 则 返回 false. 
语法 


chdir(directory) 


参数 


directory 必需 。 规 定 新 的 当前 目录 。 


例子 


<?php 

// 获 得 当前 目录 
echo getcwd(); 
echo "<br /»"; 





// 改 变 为 images 目录 
chdir("images"); 
echo "<br />"; 
echo getcwd(); 

?> 


输出 : 


C:NtestwebNmain 
C:\testweb\main\images 


PHP chroot() HŽ% 


定义 和 用 法 
chroot() 函数 把 当前 进程 的 根 目录 改变 为 指定 的 目录 。 


若 成 功 ， 则 该 男 数 返回 true， 否 则 返回 false, 
语法 
chroot(directory) 


参数 


directory 必需 。 规 定 新 的 根 目录 。 


提示 和 注释 


提示 : 该 函数 没有 在 Windows 平台 上 实现 。 


PHP dir() 2X 


定义 和 用 法 
dir() 函数 打开 一 个 目录 句柄 ， 并 返回 一 个 对 象 。 这 个 对 象 包 含 三 个 方法 : read() , rewind() 以 
及 close()。 


若 成 功 ， 则 该 函数 返回 一 个 目录 流 ， 否 则 返回 false 以 及 一 个 error. DLAs TERINA B JD 
+ "@" 来 隐藏 error 的 输出 。 


语法 
dir(directory) 
BR 描述 
directory 必需 。 规 定 目录 。 


例子 
例子 1 


<?php 
// 打 开 images 目录 
$dir = dir("images"); 


// 列 出 images 目录 中 的 文件 
while (($file = $dir->read()) !== false) 


echo "filename: " . $file . "<br />"; 


J 


$dir ->close(), 
?> 


输出 : 


filename: . 
filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


例子 2 
如 果 dir() 的 输出 失败 ， 本 例会 隐藏 错误 : 


<?php 
// 打 开 images Až 
$dir = © dir("images"); 


// 列 出 images 目录 中 的 文件 


while (($file = $dir->read()) !== false) 
echo "filename: " . $file . "<br />", 
} 

$dir->close(); 

?> 


输出 : 


filename: 

filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


PHP closedir() 函数 


定义 和 用 法 


closedir() RŽ m EH opendir() ABTAWAROM, 


closedir(dir stream) 


参数 描述 
dir stream 必需 。 规 定 要 关闭 的 目录 句柄 。 


例子 


<?php 
// 打 开 images 目录 
$dir = opendir("images"); 


// 列 出 images 目录 中 的 文件 
while (($file = readdir($dir)) !== false) 


echo "filename: " . $file . "<br />", 


closedir($dir), 
?> 


输出 : 


filename: . 
filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


PHP getcwd() 2X 


定义 和 用 法 
getcwd() 函数 返回 当前 目录 。 


若 成 功 ， 则 返回 当前 工作 目录 ， 否 则 返回 false, 
语法 


getcwd() 


例子 


<?php 
echo getcwd(), 
?> 


输出 : 


C:NtestwebNmain 


PHP opendir() 2X 


定义 和 用 法 
opendir() 函数 打开 一 个 目录 句柄 ， 可 由 closedir(), readdir() 和 rewinddir() 使 用 。 


若 成 功 ， 则 该 图 数 返 回 一 个 目录 流 ， 否 则 返回 false 以 及 一 个 error。 可 以 通过 在 函数 名 前 加 
上 "@" 来 隐藏 error s $1 the 


语法 


opendir(path, context) 


参数 描述 
path 必需 。 规 定 要 打开 的 目录 路 径 。 
context Ait, WEB MMe. context 是 可 修改 目录 流 的 行为 的 一 套 选项 。 


A —1inds 
提示 和 注释 
注释 : M PHP 5.0.0 FHS, path 参数 支持 ftp:// URL wrapper. 


注释 : 在 PHP 4.3.0 中 ， path 参数 可 以 是 任何 支持 目录 列表 的 URL， 不 过 在 PHP 4 中 只 有 
file:// URL wrapper 支持 此 功能 。 


例子 
例子 1 


<?php 
// 打 开 images 目录 
$dir = opendir("images"); 


// 列 出 images 目录 中 的 文件 
while (($file = readdir($dir)) !== false) 


echo "filename: " . $file . "<br />"; 


closedir($dir); 
?> 


输出 : 


filename: 

filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


例子 2 
如 果 opendir() 的 输出 失败 ， 本 例会 隐藏 错误 : 


<?php 
// 打 开 images 目录 
$dir = © opendir("images"); 


// 列 出 images 目录 中 的 文件 
while (($file = readdir($dir)) !== false) 


echo "filename: " . $file . "<br />", 


closedir($dir); 
?> 


输出 : 


filename: 

filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


PHP readdir() 函数 


定义 和 用 法 
readdir() 函数 返回 由 opendir() 打开 的 目录 句柄 中 的 条 目 。 
若 成 功 ， 则 该 函数 返回 一 个 文件 名 ， 否 则 返回 false. 


语法 


readdir(dir stream) 


参数 描述 
dir stream 必需 。 规 定 要 使 用 的 目录 句柄 。 


说 明 


返回 目录 中 下 一 个 文件 的 文件 名 。 文 件 名 以 在 文件 系统 中 的 排序 返回 


例子 


<?php 
// 打 开 images Až 
$dir = opendir("images"); 


// 列 出 images 目录 中 的 文件 
while (($file = readdir($dir)) !== false) 


echo "filename: " . $file . "<br />"; 


closedir($dir); 
?» 


输出 : 


filename: . 
filename: .. 
filename: cat.gif 
filename: dog.gif 
filename: food 
filename: horse.gif 


o 


PHP rewinddir() E325 


定义 和 用 法 
rewinddir() 函数 重 置 由 opendir() 打开 的 目录 句柄 。 
R 


本 函数 什么 都 不 会 返回 。 
语法 


rewinddir(dir stream) 


参数 描述 
dir stream 必需 。 规 定 要 使 用 的 目录 句柄 。 


提示 和 注释 


提示 : 本 函数 重读 目录 ， 并 可 用 于 检查 目录 中 的 变化 。 


例子 


<?php 
// 打 开 images Až 
$dir = opendir("images"); 


// 列 出 images 目录 中 的 文件 





while (($file = readdir($dir)) !== false) 
echo "filename: " . $file . "<br />", 
} 

// 重 置 目录 流 


rewinddir($dir); 
// 供 检查 变化 的 代码 


closedir ($dir); 
?> 


PHP scandir() HŽ% 


定义 和 用 法 
scandir() 函数 返回 一 个 数组 ， 其 中 包含 指定 路 径 中 的 文件 和 目录 。 


若 成 功 ， 则 返回 一 个 数组 ， 若 失败 ， 则 返回 false, WR directory 不 是 目录 ， 则 返回 布尔 值 
false A. RE WARNING 级 的 错误 。 


语法 


scandir(directory,sort,context) 


BR 描述 

要 扫描 的 目录 。 

排列 顺序 。 默 认 是 0 (升序 ) 。 如 果 是 1， 则 为 降序 。 

目录 句柄 的 环境 。context 是 可 修改 目录 流 的 行为 的 一 套 选 项 。 


directory Wa 


需 
sort 可 选 。 


n s " 


加 
B 


context 


例子 


<?php 
print r(scandir("images")); 
?> 


[2] => dog.jpg 
[3] => house. jpg 
[4] => logo.gif 


PHP Error 和 Logging MŽ% 


PHP Error 和 Logging 简介 


error 和 logging BAR Jo zr fo #4 


误 进 行 处 理 和 11 3 o 


error 函数 允许 用 户 定义 错误 义理 规则 ， 并 修改 记录 错误 的 方式 。 


logging ES28 76 zr FH P xt 75 FREE FF St 
其 他 的 机 器 。 


> 


+ 
安装 


行 日 志 记 录 ， 并 把 日 志 消 息 发 送 到 电子 邮件 、 系统 日 志 或 


error 和 logging He PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 函 数 。 


PHP Error 和 Logging HX 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


函数 
debug_backtrace() 
debug print backtrace() 


error get last() 
error log() 


error reporting() 
restore error handler() 
restore exception handler() 
set error handler() 

set exception handler() 
trigger error() 


user error() 


PHP Error 和 Logging ®= 


生成 backtrace. 

输出 backtrace. 

获得 最 后 发 生 的 错误 。 

向 服务 器 错误 记录 、 文 件 或 远程 目标 发 送 一 个 错 


误 。 

规定 报告 哪个 错误 。 

恢复 之 前 的 错误 义理 程序 。 

恢复 之 前 的 异常 义理 程序 。 
i& FH P BELA RE 

置 用 户 自 定义 的 异常 处 理 
创建 用 户 自 定义 的 错误 消息 。 
trigger_error() 的 别名 。 


9 数 。 
S ŠT. 


到 Bi 


E 


PHP 


A A oOo A c A AR 


PHP : 指示 支持 该 


值 


Hal 


常 


E_ERROR 


E_WARNING 


E_PARSE 


E_NOTICE 


E_CORE_ERROR 

E CORE WARNING 

E COMPILE ERROR 

E COMPILE WARNING 


E USER ERROR 


E USER WARNING 


E USER NOTICE 


E STRICT 


E RECOVERABLE ERROR 


E ALL 


常量 的 最 早 的 PHP 版 本 。 


描述 


致命 的 运行 时 错误 。 错 误 无 法 恢复 。 
脚本 的 执行 被 中 断 。 


非 致命 的 运行 时 错误 。 脚 本 的 执行 不 
会 中 断 。 


编译 时 语法 解析 错误 。 解 析 错 误 只 应 
该 由 解析 器 生成 。 


运行 时 提示 。 可 能 是 错 Bik, 也 可 能 在 
正常 运行 脚本 时 发 生 。 


由 PHP 内 部 生成 的 错误 。 
由 PHP 内 部 生成 的 警告 。 
由 Zend 脚本 引擎 内 部 生成 的 错误 。 
由 Zend 脚本 引擎 内 部 生成 的 警告 。 


由 于 调用 trigger error() EEX px Bie 
行 时 错误 。 
由 于 调用 trigger error() ER 


行 时 警告 。 


数 生成 的 运 


由 于 调用 trigger_error() EEX px Bis 
行 时 提示 。 

运行 时 提示 。 对 增强 代码 的 互 用 性 和 
兼容 性 有 益 。 


可 捕获 的 致命 错误 。 


set error handler()) 


所 有 的 错误 和 和 警告， 除了 
E_STRICT。 





(参阅 


PHP 


A A H A 


PHP debug. backtrace() 2X 


re. : 
定义 和 用 法 
PHP debug backtrace() HÆ% —^ backtrace. 


该 图 数 返 回 一 个 关联 数组 。 下 面 是 可 能 返回 的 元 素 : 


名 称 a 描述 
字 
function 4 当前 的 函数 名 。 
$ 
Ek RARUS 
line 数 当前 的 行 号 。 
字 
file foo HANA. 
$ 
+ 
class 符 当前 的 类 名 
串 
object 由 当前 对 象 。 
当前 的 调用 类 型 ， 可 能 的 调用 : 返回 :" ->" - 方法 调用 返回 :" ::"- 
yP 中 ”静态 方法 调用 返回 nothing - RAA 
m 数 ”” 如 果 在 画 数 中 ， 列 出 函数 参数 。 如 果 在 被 引用 的 文件 中 ， 列 出 被 引用 
9 组 ”的 文件 名 。 
语法 


debug_backtrace() 


例子 


<?php 
function one($str1, $str2) 


two( "Glenn", "Quagmire"); 
function two($str1, $str2) 
three( "Cleveland", "Brown"); 
function three($stri, $str2) 


print r(debug backtrace()), 
J 


one( "Peter", "Griffin"); 
?» 


输出 : 


Array 
( 
[0] => Array 
( 
[file] -» C:NwebfolderNtest.php 
[line] -» 7 
[function] -» three 
[args] -» Array 
( 
[0] => Cleveland 
[1] => Brown 
) 
) 
[1] => Array 
( 
[file] -» C:NwebfolderNtest.php 
[line] -» 3 
[function] -» two 
[args] => Array 
( 
[0] => Glenn 
[1] => Quagmire 
) 
) 
[2] => Array 
( 
[file] => C:\webfolder\test.php 
[line] => 14 
[function] => one 
[args] => Array 
( 
[0] => Peter 
[1] => Griffin 
) 
) 
) 


PHP debug print backtrace() 2 


= 、 : 
debug print backtrace() E2447 H4 backtrace, 
语法 


debug_print_backtrace() 


例子 


<?php 
function one($stri, $str2) 


two( "Glenn", "Quagmire"); 
O... two($str1, $str2) 
three( "Cleveland", "Brown"); 
E on three($str1, $str2) 
debug print backtrace); 


one("Peter", "Griffin"); 
?» 


输出 : 


#0 three(Cleveland, Brown) called at [C:\webfolder\test.php:8] 
#1 two(Glenn, Quagmire) called at [C:\webfolder\test.php:4] 
#2 one(Peter, Griffin) called at [C:\webfolder\test.php:15] 


PHP error get last() 函数 


定义 和 用 法 
error get last() 本 数 获取 最 后 发 生 的 错误 。 
该 函数 以 数组 的 形式 返回 最 后 发 生 的 错误 。 
返回 的 数组 包含 4 个 键 和 值 : 

e [type] - 错误 类 型 

e [message] - 错误 消息 


e [file] - 发 生 错 误 所 在 的 文件 
。 [line] - 发 生 错误 所 在 的 行 


语法 


error get last() 


例子 


<?php 

echo $test, 

print r(error get last()); 
?> 


输出 : 


Array 


( 

[type] -» 8 

[message] -» Undefined variable: test 
[file] => C:\webfolder\test.php 
[line] => 2 

) 


PHP error log() EZ 


定义 和 用 法 
error log() 函数 向 服务 器 错误 记录 、 文 件 或 远程 目标 发 送 一 个 错误 。 


若 成 功 ， 返 回 true， 否 则 返回 false. 
语法 


error log(error,type,destination,headers) 


BR 描述 
error 必需 。 要 记录 的 错误 消息 。 


可 选 。 规 定 错误 记录 的 类 型 。 可 能 的 记录 类 型 : 0 - Rit. MBE 
php.ini 文件 中 的 error log 配置 ， 错 误 被 发 送 到 服务 器 日 志 系统 或 文件 。 

type 1 - 错误 被 发 送 到 destination 参数 中 的 地 址 。 只 有 该 类 型 使 用 headers 
参数 。 2 -通过 PHP debugging 连接 来 发 送 错误 。 该 选项 只 在 PHP 3 中 
可 用 。 3 - 错误 发 送 到 文件 目标 字符 串 。 


destination ， 可 选 。 规 定向 何 处 发 送 错误 消息 。 该 参数 的 值 依 赖 于 "type" 参数 的 值 。 


可 选 。 只 在 "type" 为 1 时 使 用 。 规 定 附加 的 头 部 ， 比 如 From, Cc 以 及 
headers Bcc, FH CRLF (mn) 分 隔 。 注释 : Bee 电子 邮件 时 ， 必 须 包 含 From X 
部 。 可 以 在 php.ini 文件 中 或 者 通过 此 参数 设置 。 


例子 
本 例 发 送 一 封 党 有 自 定义 错误 的 电子 邮件 : 


<?php 
$test-2; 
if ($test>1) 


error log("A custom error has been triggered", 
1, "someonelexample.com", "From: webmasterQexample.com"); 


?> 


输出 : 


A custom error has been triggered 


W3School PHP 参考 手册 


PHP error log() 函数 286 


PHP error reporting() 函数 
定义 和 用 法 
error_reporting() 设置 PHP 的 报错 级 别 并 返回 当前 级 别 。 
语法 

error reporting(report level) 


RE level 未 指定 ， 当 前 报错 级 别 将 被 返回 。 下 面 几 项 是 level 可 能 的 值 : 


16 


32 


64 
128 
256 
512 
1024 
2048 
4096 


8191 


例子 


常量 
E_ERROR 
E_WARNING 
E_PARSE 
E_NOTICE 


E_CORE_ERROR 


E_CORE_WARNING 


E_COMPILE_ERROR 


E COMPILE WARNING 


E USER ERROR 


E USER WARNING 


E USER NOTICE 


E STRICT 


E RECOVERABLE ERROR 


E ALL 


描述 


Fatal run-time errors. Errors that can not be 
recovered from. Execution of the script is 
halted 


Non-fatal run-time errors. Execution of the 
script is not halted 


Compile-time parse errors. Parse errors 
should only be generated by the parser 


Run-time notices. The script found something 
that might be an error, but could also happen 
when running a script normally 


Fatal errors at PHP startup. This is like an 
E ERROR in the PHP core 


Non-fatal errors at PHP startup. This is like an 
E WARNING in the PHP core 


Fatal compile-time errors. This is like an 
E ERROR generated by the Zend Scripting 
Engine 


Non-fatal compile-time errors. This is like an 
E WARNING generated by the Zend Scripting 
Engine 


Fatal user-generated error. This is like an 
E ERROR set by the programmer using the 
PHP function trigger error() 


Non-fatal user-generated warning. This is like 
an E WARNING set by the programmer using 
the PHP function trigger error() 


User-generated notice. This is like an 
E NOTICE set by the programmer using the 
PHP function trigger error() 


Run-time notices. PHP suggest changes to 
your code to help interoperability and 
compatibility of the code 


Catchable fatal error. This is like an 
E ERROR but can be caught by a user 
defined handle (see also set error handler()) 


All errors and warnings, except level 
E STRICT (E STRICT will be part of E ALL 
as of PHP 6.0) 


任意 数目 的 以 上 选项 都 可 以 用 "或 "来 连接 (用 OR 或 |) ， 这 样 可 以 报告 所 有 需要 的 各 级 别 错 
误 。 例 如 ， 下 面 的 代码 关闭 了 用 户 自 定 义 的 错误 和 警告 ， 执 行 了 某 些 操作 ， 然 后 恢复 到 原始 
的 报错 级 别 : 


<?php 
// 禁 用 错误 报告 
error reporting(0); 


// 报 告 运行 时 错误 
error reporting(E ERROR | E WARNING | E PARSE), 
// 报 告 所 有 错误 


error reporting(E ALL), 
?> 


PHP restore error handler() Až 


定义 和 用 法 


restore error handler() 函数 恢复 之 前 的 错误 处 理 程序 ， 该 程序 是 由 set error handler() 函数 
改变 的 。 


3X KK ix 3 [B] true. 


语法 


restore error handler() 


提示 和 注释 


提示 : 之 前 的 错误 处 理 程序 可 能 是 在 错误 处 理 程序 或 用 户 自 定义 图 数 中 构建 的 。 


例子 


<?php 
//custom error handler function 
function customError($errno, $errstr, $errfile, $errline) 


echo "<b>Custom error:«/b» [$errno] $errstr<br /»"; 
echo " Error on line $errline in $errfile<br /»"; 


j 


//set user-defined error handler 
set error handler("customError"); 


$test-2; 


//trigger error 
if ($test>1) 


trigger error("A custom error has been triggered"); 


//restore built-in error handler 
restore error handler 


//trigger error again 
if ($test>1) 
{ 


trigger_error("A custom error has been triggered"); 


} 


?> 


输出 : 
**Custom error:** [1024] A custom error has been triggered 
Error on line 14 in C:\webfolder\test.php 


**Notice**: A custom error has been triggered in ** 
C:NwebfolderNtest.php** on line **21** 


PHP restore exception handler() 2% 


定义 和 用 法 


restore exception handler() 函数 恢复 之 前 的 异常 处 理 程序 ， 该 程序 是 由 
set exception handler() 函数 改变 的 。 


该 图 数 永远 返回 true, 


restore exception handler() 


提示 和 注释 


提示 : 之 前 的 异常 处 理 程序 可 能 是 在 异常 处 理 程序 或 用 户 自 定义 图 数 中 构建 的 。 


例子 


<?php 
restore exception handler(); 


throw new Exception('Uncaught Exception occured'); 
?> 


输出 : 


**Fatal error**: Uncaught exception "Exception" with message 
'Uncaught Exception occured' in C:\webfolder\test.php:4 
Stack trace: #0 {main} thrown in **C:NwebfolderNtest.php** on line **4** 


PHP set error handler() 函数 


ch 、 : 
定义 和 用 法 

set error handler() 函数 设置 用 户 自 定义 的 错误 处 理 辑 数 。 
该 图 数 用 于 创建 运行 时 期 间 的 用 户 自己 的 错误 处 理 方法 。 


该 范 数 会 返回 旧 的 错误 义理 程序 ， 若 失败 ， 则 返回 null. 
语法 


set error handler(error function,error types) 


参数 描述 
error function Wie. MERE BIR TAR, 


可 选 。 规 定 在 哪个 错误 报告 级 别 会 显示 用 户 定义 的 错误 。 默 认 是 


error types "E ALL", 


提示 和 注释 
提示 : RAT AM, SEPA AEN PHP 错误 义理 函数 ， 如 果 必 要 ， 用 户 定义 的 错 
误 处 理 程序 必须 终止 (die() ) 脚本 。 


注释 : 如 果 在 脚本 执行 前 发 生 错误 ， 由 于 在 那 时 自 定 义 程序 还 没有 注册 ， 因 此 就 不 会 用 到 这 
个 自 定义 错误 处 理 程序 。 


例子 


<?php 
//error handler function 
function customError($errno, $errstr, $errfile, $errline) 


echo "<b>Custom error:«/b» [$errno] $errstr<br />"; 
echo " Error on line $errline in $errfile<br /»"; 
echo "Ending Script"; 

die(); 


//set error handler 
set error handler("customError"); 


$test-2; 


//trigger error 
if ($test>1) 
{ 


trigger_error("A custom error has been triggered"); 


} 


?> 


输出 : 


**Custom error:** [1024] A custom error has been triggered 
Error on line 19 in C:\webfolder\test.php 
Ending Script 
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ch 、 : 

set exception handler() KAŠE FH ^ El E SL) SE RIE. 
该 图 数 用 于 创建 运行 时 期 间 的 用 户 自己 的 异常 处 理 方法 。 

该 图 数 会 返回 旧 的 异常 处 理 程序 ， 若 失败 ， 则 返回 null. 


语法 


set exception handler(exception function) 


参数 描述 
必需 。 规 定 未 捕获 a 该 函数 必 d ec 
error function set exception handler() TH PABUZAJE Lo RSF LEA SSS 


个 参数 ， 即 抛 出 的 exception 对 象 。 
提示 和 注释 
提示 : 在 这 个 异常 义理 程序 被 调用 后 ， 脚 本 会 停止 执行 。 


例子 


<?php 

function myException($exception) 

echo "<b>Exception:</b> " , $exception->getMessage(); 
J 


set exception handler( myException'); 


throw new Exception('Uncaught Exception occurred'); 
?> 


输出 : 


**Exception:** Uncaught Exception occurred 


+ 


PHP trigger error() 2 


A 


er 、 : 
trigger error() HAO) BEH PES A6 OH LS 


trigger error() 用 于 在 用 户 指 定 的 条 件 下 触发 一 个 错误 消息 。 它 与 内 建 的 错误 处 理 器 一 同 使 
用 ， 也 可 以 与 由 set error handler() Eq e] E B Fl BE st ER IUS FB. 


如 果 指 定 了 一 个 不 合法 的 错误 类 型 ， 该 函数 返回 false, AIRE true. 
语法 


trigger error(error message,error types) 


参数 描述 
error message — 必需 。 规 定 错 误 消 息 。 长 度 限制 为 1024 个 字符 。 


可 选 。 规 定 错误 消息 的 错误 类 型 。 可 能 的 值 : E USER ERROR 


error types 
= E USER WARNING E USER NOTICE 


例子 


<?php 
$test-2; 

if ($test>1) 
{ 


trigger_error("A custom error has been triggered"); 


?> 


俞 出 : 


**Notice**: A custom error has been triggered 
in **C:NwebfolderNtest.php** on line **6** 
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PHP Filesystem 简介 


Filesystem EXE 44K ARER Ao 

ra Jc 

ZO 

Filesystem KÄE PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 函 数 。 


Runtime 配置 


文件 系统 函数 的 行为 受到 php.ini 中 设置 的 影响 。 
文件 系统 配置 选项 : 


名 称 默认 描述 可 改变 


本 选项 激活 了 URL 形式 的 

fopen 封装 协议 使 得 可 以 

访问 URL 对 象 例如 文件 。 

默认 的 封装 协议 提供 用 ftp 

allow url fopen #15 和 http 协议 来 访问 远程 文 PHP_INI_SYSTEM 
件 ， 一 些 扩展 库 例如 
可 能 会 注册 更 多 的 封装 
议 。 (PHP 4.0.4 "a 
可 用 。) 


定义 PHP 发 送 的 User- 
user_agent NULL Agent, (PHP 4.3.0 版 以 ”PHP_INI ALL 
后 可 用 。) 


基于 socket 的 流 的 默认 超 
default socket timeout "60" 时 时 间 ( 秒 )。 (PHP 4.3.0 PHP INI ALL 
版 以 后 可 用 。 ) 


M 定义 匿名 ftp 的 密码 (您 
Don 的 email HEHE) 。 


当 设 为 On 时 ，PHP 将 检 
查 通过 fgets() 和 file() 取 
得 的 数据 中 的 行 结束 符号 
是 符合 Unix，MS-DOS， 
还 是 Macintosh 的 习惯 。 
这 使 得 PHP 可 以 和 
Macintosh 系统 交互 操 
auto detect line endings — "0" 作 ， 但 是 默认 值 是 Off， PHP INI ALL 
因为 在 检 测 第 一 行 的 EOL 
习惯 时 会 有 很 小 的 性 能 损 
" 而 且 在 Unix 系统 下 使 
用 回 车 符号 作为 项 目 分 隔 
符 的 人 们 会 遭遇 向 下 不 兼 
容 的 行为 。 (PHP 4.3.0 
版 以 后 可 用 。) 


PHP INI ALL 


Unix / Windows 兼容 性 

STE Unix 平台 上 规定 路 径 时 ， 正 斜 杠 (/) 用 作 目 录 分 隔 符 。 而 在 Windows FA E, ERHI (/) 
MEHI () 均 可 使 用 。 

PHP Filesystem 2X 

PHP : BRAKE PHP 版 本 。 


画 数 描述 PHE 
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basename() 
chgrp() 

chmod() 

chown() 
clearstatcache() 
copy() 

delete() 

dirname() 
disk_free_space() 
disk_total_space() 
diskfreespace() 
fclose() 

feof() 

fflush() 

fgetc() 

fgetcsv() 

fgets() 


fgetss() 


file() 

file exists() 

file get contents() 
file put contents() 
fileatime() 
filectime() 
filegroup() 
fileinode() 
filemtime() 
fileowner() 
fileperms() 
filesize() 


filetype() 
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返回 路 径 中 的 文件 名 部 分 。 

改变 文件 组 。 

改变 文件 模式 。 

改变 文件 所 有 者 。 

清除 文件 状态 缓存 。 

复制 文件 。 

参见 unlink() 或 unset()。 

返回 路 径 中 的 目录 名 称 部 分 。 
返回 目录 的 可 用 空间 。 

返回 一 个 目录 的 磁盘 总 容量 。 

disk free space() 的 别名 。 

关闭 打开 的 文件 。 

测试 文件 指针 是 否 到 了 文件 结束 的 位 置 。 
向 打开 的 文件 输出 缓冲 内 容 。 

从 打开 的 文件 中 返回 字符 。 

从 打开 的 文件 中 解析 一 行 ， 校 验 CSV FR. 
从 打开 的 文件 中 返回 一 行 。 


从 打开 的 文件 中 读 取 一 行 并 过 滤 掉 HTML 和 PHP 45 
记 。 


把 文件 读 入 一 个 数组 中 。 
检查 文件 或 目录 是 否 存在 。 
将 文件 读 和 人 字符 串 。 

将 字符 串 写 入 文件 。 

返回 文件 的 上 次 访问 时 间 。 
返回 文件 的 上 次 改变 时 间 。 
返回 文件 的 组 ID. 

返回 文件 的 inode 编号 。 
返回 文件 的 上 次 修改 时 间 。 
文件 的 user ID (所 有 者 ) 。 
返回 文件 的 权限 。 

返回 文件 大 小 。 

返回 文件 类 型 。 
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flock() 
fnmatch() 


fopen() 
fpassthru() 


fputcsv() 
fputs() 
fread() 
fscanf() 

fseek() 

fstat() 

ftell() 
ftruncate() 
fwrite() 

glob() 

is dir() 

is executable() 
is file() 

is link() 


is readable() 


is uploaded file() 


is writable() 
is writeable() 
link() 
linkinfo() 
Istat() 

mkdir() 


move uploaded file() 


parse ini file() 
pathinfo() 
pclose() 


popen() 


> — . XH 
PHP Filesystem P425 
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Y 


锁定 或 释放 文件 。 
根据 指定 的 模式 来 匹配 文件 名 或 字符 串 。 
4171 PD ocak URL, 


从 打开 的 文件 中 读数 据 ， 直 到 EOF， 并 向 输出 缓冲 写 
结果 。 


将 行 格式 化 为 CSV 并 写 入 一 个 打开 的 文件 中 。 
fwrite() 的 别名 。 

读 取 打 开 的 文件 。 

根据 指定 的 格式 对 输入 进行 解析 。 

在 打开 的 文件 中 定位 。 

返回 关于 一 个 打开 的 文件 的 信息 。 

返回 文件 指针 的 读 / 写 位 置 

将 文件 截断 到 指定 的 长 度 。 

写 入 文件 。 

返回 一 个 包含 匹配 指定 模式 的 文件 名 /目录 的 数组 。 
判断 指定 的 文件 名 是 否 是 一 个 目录 。 
判断 文件 是 否 可 执行 。 

判断 指定 文件 是 否 为 常规 的 文件 。 

判断 指定 的 文件 是 否 是 连接 。 
判断 文件 是 否 可 读 。 

判断 文件 是 否 是 通过 HTTP POST 上 传 的 。 
判断 文件 是 否 可 写 。 

is_writable() 的 别名 。 

创建 一 个 硬 连 接 。 

返回 有 关 一 个 硬 连 接 的 信息 。 

返回 关于 文件 或 符号 连接 的 信息 。 

创建 目录 。 

将 上 传 的 文件 移动 到 新 位 置 。 
解析 一 个 配置 文件 。 

返回 关于 文件 路 径 的 信息 。 

关闭 有 popen() 打开 的 进程 。 
打开 一 个 进程 。 


DAmDnnnpnnpnnpn 和 nnpnnnpnnnpn 上 上 nn 上 nn 上 和 mn QC 


readfile() 读 取 一 个 文件 ， 并 输出 到 输出 缓冲 。 3 
readlink() 返回 符号 连接 的 目标 。 3 
realpath() 返回 绝对 路 径 名 。 4 
rename() 重 名 名 文件 或 目录 。 3 
rewind() 到 回 文件 指针 的 位 置 。 3 
rmdir() 删除 空 的 目录 。 3 
set file buffer() 设置 已 打开 文件 的 缓冲 大 小 。 3 
stat() 返回 关于 文件 的 信息 。 3 
symlink() 创建 符号 连接 。 3 
tempnam() 创建 唯一 的 临时 文件 。 3 
tmpfile() 建立 临时 文件 。 3 
touch() 设置 文件 的 访问 和 修改 时 间 。 3 
umask() 改变 文件 的 文件 权限 。 3 
unlink() 删除 文件 。 3 
PHP Filesystem 常量 
PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 

常量 描述 PHP 
GLOB BRACE 
GLOB ONLYDIR 
GLOB MARK 


GLOB NOSORT 

GLOB NOCHECK 

GLOB NOESCAPE 
PATHINFO DIRNAME 
PATHINFO BASENAME 
PATHINFO EXTENSION 
FILE USE INCLUDE PATH 
FILE APPEND 

FILE IGNORE NEW LINES 
FILE SKIP EMPTY LINES 
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PHP basename() 函数 
定义 和 用 法 

basename() 函数 返回 路 径 中 的 文件 名 部 分 。 
语法 


basename(path, suffix) 


参数 描述 
path 必需 。 规 定 要 检查 的 路 径 。 
suffix 可 选 。 规 定 文件 扩展 名 。 如 果 文 件 有 suffix， 则 不 会 输出 这 个 扩展 名 。 


例子 


<?php 
$path = "/testweb/home.php"; 


// 显 示 带 有 文件 扩展 名 的 文件 名 


echo basename($path) ; 
// 显 示 不 带 有 文件 扩展 名 的 文件 名 


echo basename($path,".php"); 
2» 


输出 : 


home. php 
home 


PHP chgrp() 2X 


定义 和 用 法 
chgrp() 画 数 改 变 文 件 所 属 的 组 。 


如 果 成 功 则 返回 TRUE， 否则 返回 FALSE. 


语法 
chgrp(file, group) 
参数 描述 
file 必需 。 规 定 要 检查 的 文件 。 
group 可 选 。 规 定 新 的 组 。 可 以 是 组 名 或 组 的 ID. 
说 明 


尝试 将 文件 file 所 属 的 组 改 成 group (通过 组 名 或 组 ID 指定 ) 。 


只 有 超级 用 户 可 以 任意 修改 文件 的 组 ， 其 它 用 户 可 能 只 能 将 文件 的 组 改 成 该 用 户 自己 所 在 的 
组 。 


例子 


<?php 
chgrp("test.txt", "admin" ) 
?> 


PHP chmod() 函数 


定义 和 用 法 
chmod() 画 数 改变 文件 模式 。 


如 果 成 功 则 返回 TRUE， 否 则 返回 FALSE. 


语法 


chmod(file,mode) 


参数 描述 
需 。 规 定 要 检查 的 文件 。 


必 
可 选 。 规 定 新 的 权限 。mode 参数 由 4 个 数字 组 成 :第 一 个 数字 永远 是 0 第 二 
mede ”个 数字 规定 所 有 者 的 权限 第 二 个 数字 规定 所 有 者 所 属 的 用 户 组 的 权限 第 四 个 数 

字 规定 其 他 所 有 人 的 权限 可 能 的 值 (如 需 设置 多 个 权限 ， 请 对 下 面 的 数字 进行 
总 计 ) : 1 - 执行 权限 2 - 写 权限 4 - 读 权限 


例子 


<?php 
// 所 有 者 可 读 写 ， 其 他 人 没有 任何 权限 
chmod("test.txt",0600); 


// 所 有 者 可 读 写 ， 其 他 人 可 读 
chmod("test.txt", 0644), 


// 所 有 者 有 所 有 权限 ， 其 他 所 有 人 可 读 和 执行 
chmod("test.txt",0755); 


// 所 有 者 有 所 有 权限 ， 所 有 者 所 在 的 组 可 读 
chmod("test.txt",0740); 
?> 


PHP chown() 函数 


定义 和 用 法 
chown() 画 数 改变 指定 文件 的 所 有 者 。 


如 果 成 功 则 返回 TRUE， 否 则 返回 FALSE. 
语法 


chown(file,owner) 


参数 描述 
file 必需 。 规 定 要 检查 的 文件 。 
owner 规定 新 的 所 有 者 。 可 以 是 用 户 名 或 用 户 的 1D。 
说 明 


尝试 将 文件 file 的 所 有 者 改 成 用 户 owner (由 用 户 名 或 用 户 ID 指定 ) 。 只 有 超级 用 户 可 以 改 
变 文件 的 所 有 者 。 


例子 


<?php 
chown("test.txt","charles") 
?> 


PHP clearstatcache() 2X 


定义 和 用 法 
clearstatcache() 函数 清除 文件 状态 缓存 。 


clearstatcache() 函数 会 缓存 某 些 函数 的 返回 信息 ， 以 便 提 供 更 高 的 性 能 。 但 是 有 时 候 ， 比 如 
在 一 个 脚本 中 多 次 检查 同一 个 文件 ， 而 该 文件 在 此 脚本 执行 期 间 有 被 删除 或 修改 的 危险 时 ， 
你 需要 清除 文件 状态 缓存 ， 以 便 获 得 正确 的 结果 。 要 做 到 这 一 点 ， 就 需要 使 用 
clearstatcache() 函数 。 


会 进行 缓存 的 函数 ， 即 受 clearstatcache() HAR AN : 


e stat() 
e Istat() 
e file exists() 

e is writable() 

e is readable() 
e is executable() 
e is file() 
e is dir() 
e is link() 
e filectime 


一 a 


e fileatime 
e filemtime 


) 
) 
() 
e fileinode() 
e filegroup() 


e fileowner() 


e filesize() 

e filetype() 

e fileperms() 
语法 


clearstatcache() 


例子 


<?ph 
// 检 查 文 件 大 小 


echo filesize("test.txt"), 
$file - fopen("test.txt", "a+"), 
// 截取 文件 


ftruncate($file, 100), 
fclose($file); 





// 清 除 缓存 并 再 次 检查 文件 大 小 
clearstatcache(), 

echo filesize("test.txt"), 
?> 


输出 : 


792 
100 


PHP copy() 函数 
定义 和 用 法 

copy() KIRGE n xc, 

语法 


copy( source , destination ) 


参数 描述 
source 必需 。 规 定 要 复制 的 文件 。 
destination 必需 。 规 定 复制 文件 的 目的 地 。 


说 明 

将 文件 从 source 拷贝 到 destination。 如 果 成 功 则 返回 TRUE， 否 则 返回 FALSE, 
提示 和 注释 

提示 : 如 果 要 移动 文件 的 话 ， 请 使 用 rename() KA 


注释 : M PHP 4.3.0 开始 ， 如 果 启 用 了 "fopen wrappers" 的 话 ，source 和 destination 都 可 以 
是 URL。 更 多 信息 见 fopen()。 如 果 destination 是 一 个 URL， 则 如 果 封 装 协 议 不 支持 覆盖 已 
有 的 文件 时 拷贝 操作 会 失败 。 


重要 事项 : 如 果 目 标 文件 已 存在 ， 将 会 被 覆盖 。 


例子 


<?php 
echo copy("source.txt","target.txt"), 
?> 


输出 : 
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PHP dirname() E325 


定义 和 用 法 


dirname() 函数 返回 路 径 中 的 目录 部 分 。 


语法 
dirname(path) 
参数 描述 
path 必需 。 规 定 要 检查 的 路 径 。 


说 明 


path 参数 是 一 个 包含 有 指向 一 个 文件 的 全 路 径 的 字符 串 。 该 汞 数 返回 去 掉 文件 名 后 的 目录 
名 。 


例子 


<?php 

echo dirname("c:/testweb/home.php"); 
echo dirname("/testweb/home.php"); 
?» 


输出 : 


c:/testweb 
/testweb 


PHP disk free space() 函数 
定义 和 用 法 
disk free space() 函数 返回 目录 中 的 可 用 空间 
语法 

disk free space(directory) 


参数 描述 
directory 必需 。 规 定 要 检查 的 目录 。 


说 明 


directory 参数 是 一 个 目录 的 字符 串 。 该 本 数 将 根据 相应 的 文件 系统 或 磁盘 分 区 返回 可 用 的 字 
节 数 。 


例子 


<?php 
echo disk free space("C:"); 
?» 


输出 : 


209693288558 


PHP disk total space() HŽ% 
定义 和 用 法 
disk total space() 函数 返回 指定 目录 的 磁盘 总 大 小 。 
语法 

disk total space(directory) 


参数 描述 
directory 必需 。 规 定 要 检查 的 目录 。 
说 明 
directory 参数 是 一 个 目录 的 字符 串 。 该 琅 数 将 根据 相应 的 文件 系统 或 磁盘 分 区 返回 所 有 的 字 
节 数 。 
提示 和 注释 
提示 : 本 函数 返回 的 是 该 目录 所 在 的 磁盘 分 区 的 总 大 小 ， 因 此 在 给 出 同一 个 磁盘 分 区 的 不 同 


目录 作为 参数 所 得 到 的 结果 完全 相同 。 在 Unix 和 Windows 200x/XP 中 都 支持 将 一 个 磁 总 分 
区 加 载 为 一 个 子 目录 ， 这 时 正确 使 用 本 函数 就 很 有 意义 。 


例子 


<?php 
echo disk total space("C:"), 
?> 


输出 类 似 这 样 : 


509693888668 


PHP diskfreespace() 函数 
定义 和 用 法 
diskfreespace() 函数 返回 目录 中 的 可 用 空间 。 该 玉 数 是 disk free space() HAN #1 Á. 
语法 
diskfreespace(directory) 


参数 描述 


directory 必需 。 规 定 要 检查 的 目录 。 


说 明 
directory 参数 是 一 个 目录 的 字符 串 。 该 函数 将 根据 相应 的 文件 系统 或 磁盘 分 区 返回 可 用 的 字 
节 数 。 


例子 


<?php 
echo diskfreespace("C:"); 
?» 


输出 : 


209693288558 


PHP fclose() HŽ% 


定义 和 用 法 


fclose() HAX A-DI AFX. 


语法 
fclose(file) 
参数 描述 
file 必需 。 规 定 要 关闭 的 文件 。 
说 明 


file 参数 是 一 个 文件 指针 。fclose() 函数 关闭 该 指针 指向 的 文件 。 
如 果 成 功 则 返回 true， 否 则 返回 false. 


文件 指针 必须 有 效 ， 并 且 是 通过 <a href-" title="">fopen()</a> 或 <a href="" 
title="">fsockopen()</a> 成 功 打开 的 。 


例子 


<?php 
$file = fopen("test.txt","r"); 


// 执 行 的 一 些 代码 ... 


fclose($file); 
?> 


PHP feof() 函数 


定义 和 用 法 
feof() HAH We EB Fk MAKE (eof). 


如 果 文 件 指针 到 了 EOF 或 者 出 错时 则 返回 TRUE， 否则 返回 一 个 错误 (包括 socket 超 
at) ， 其 它 情况 则 返回 FALSE, 


语法 
feof(file) 
参数 描述 
file 必需 。 规 定 要 检查 的 打开 文件 。 
说 明 


file 参数 是 一 个 文件 指针 。 这 个 文件 指针 必须 有 效 ， 并 且 必 须 指向 一 个 由 fopen() 或 
fsockopen() 成 功 打 开 (但 还 没有 被 fclose() 关闭 ) 的 文件 。 

提示 和 注释 

提示 : feof() 辑 数 对 通 历 长 度 未 知 的 数据 很 有 用 。 


注意 : 如 果 服 务 器 没有 关闭 由 fsockopen() 所 打开 的 连接 ，feof() 会 一 直 等 待 直 到 超时 而 返回 
TRUE。 上 默认 的 超时 限制 是 60 秒 ， 可 以 使 用 stream set timeout() 来 改变 这 个 值 。 


注意 : 如 果 传 递 的 文件 指针 无 效 可 能 会 陷入 无 限 循环 中 ， 因 为 EOF 不 会 返回 TRUE, 


例子 


<?php 
$file - fopen("test.txt", "r"), 


// 输 出 文本 中 所 有 的 行 ， 直 到 文件 结束 为 止 。 
while(! feof($file)) 


echo fgets($file). "<br /»"; 


fclose($file); 
?> 


输出 : 


Hello, this is a test file. 
There are three lines here. 
This is the last line. 


PHP fflush() 函数 


定义 和 用 法 


fflush() 本 数 将 缓冲 内 容 输出 到 文件 。 


语法 

fflush(file) 

file 必需 。 规 定 要 检查 的 文件 流 。 
说 明 


ARB rb ERIT 2 REAL 48 H3. file 文件 句柄 所 指向 的 资源 。 如 果 成 功 则 返回 true, SAE 
回 false。 


文件 指针 必须 有 效 ， 并 且 必 须 指向 一 个 由 fopen() 或 fsockopen() 成 功 打开 (但 还 没有 被 
fclose() 关闭 ) 的 文件 。 


例子 


<?php 
file = fopen("test.txt","r+"), 


// 一 些 代码 


fflush($file) ; 
?> 


PHP fgetc() 函数 


定义 和 用 法 


fgetc() 画 数 从 文件 指针 中 读 取 一 个 字符 。 


语法 
fgetc(file) 
参数 描述 
file 必需 。 规 定 要 检查 的 文件 。 
说 明 


返回 一 个 包含 有 一 个 字符 的 字符 串 ， 该 字符 从 file 指向 的 文件 中 得 到 。 磁 到 EOF 则 返回 
false。 


文件 指针 必须 有 效 ， 并 且 必 须 指 向 一 个 由 fopen() 或 fsockopen() 成 功 打 开 (但 还 没有 被 
fclose() 关闭 ) 的 文件 。 


日 一 TF + 
提示 和 LEE 
注意 : ZLA TAR fe a false， 但 也 可 能 返回 一 个 与 false 等 值 的 非 布尔 值 ， 例 如 0 或 
者 
注释 : 该 画 数 可 安全 用 于 二 进 制 对 象 。 


例子 
例子 1 


<?php 

$file = fopen("test.txt","r"); 
echo fgetc($file); 
fclose($file); 


2» 


输出 类 似 : 


例子 2 


<?php 
$file = fopen("test.txt","r"); 
while (! feof ($file)) 


{ 
echo fgetc($file); 
} 


fclose($file); 
?> 


输出 类 似 : 


Hello, this is a test file. 


PHP fgetcsv() HŽ 


定义 和 用 法 
fgetcsv() 函数 从 文件 指针 中 读 和 一行 并 解析 CSV FR. 


与 fgets() 类 似 ， 不 同 的 是 fgetcsv() 解析 读 和 的 行 并 找 出 CSV 格式 的 字段 ， 然 后 返回 
含 这 些 字段 的 数组 。 


fgetcsv() 出 错时 返回 FALSE， 包 括 碰 到 文件 结束 时 。 
注释 : 从 PHP 4.3.5 起 ，fgetcsv() 的 操作 是 二 进 制 安全 的 。 


语法 
fgetcsv(file, length, separator, enclosure) 


file 必需 。 规 定 要 检查 的 文件 。 


一 个 包 


可 选 。 规 定 行 的 最 大 长 度 。 必 须 大 于 CVS 文件 内 最 长 的 一 行 。 在 PHP 5 中 


该 参数 是 可 选 的 。 在 PHP 5 之 前 是 必需 的 。 如 果 和 忽略 (在 PHP 5.0.4 以 后 


ey 的 版 本 中 设 为 0) 该 参数 的 话 ， 那 么 长 度 就 没有 限制 ， 不 过 可 能 会 影响 执行 


效率 。 
separator ”可 选 。 设 置 字 段 分 界 符 (只 人 允许 一 个 字符 ) ， 默 认 值 为 逗号 。 


enclosure BHP 4.3.0 ch MA 


提示 和 注释 


注释 : CSV 文件 中 的 空 行将 被 返回 为 一 个 包含 有 单个 null 字段 的 数组 ， 不 会 被 当成 错误 。 


可 选 。 设 置 字段 环绕 符 (只 人 允许 一 个 字符 ) ， 默 认 值 为 双 引 号 。 该 参数 是 在 


注释 : 该 图 数 对 区 域 设置 是 敏感 的 。 上 比如 说 LANG 设 为 en US.UTF-8 的 话 ， 单 字 节 编码 的 


文件 SR 现 读 取 错 误 。 


注释 : 如 果 碰 到 PHP 在 读 取 文 件 时 不 能 识别 Macintosh 文件 的 行 结束 符 ， 可 以 激活 
auto detect line endings 运行 时 配置 选项 。 


例子 


例子 1 


<?php 
$file - fopen("contacts.csv","r"); 


print r(fgetcsv($file)); 
fclose($file); 


?> 


CSV 文件 : 


George，John，Thomas， USA 
James, Adrew, Martin, USA 


输出 类 似 : 
Array 
( 
[0] => George 
[1] => John 
[2] => Thomas 
[3] => USA 


) 


例子 2 


<?php 
$file = fopen("contacts.csv","r"); 
while(! feof($file) ) 


print r(fgetcsv($file)); 
} 


fclose($file); 


?> 


CSV 文件 : 


George, John, Thomas, USA 
James, Adrew, Martin, USA 


输出 类 似 : 


( 

[0] => 
[1] => 
[2] => 
[3] => 
Array 
( 

[0] => 
[1] => 
[2] => 
[3] => 


George 
John 
Thomas 
USA 


James 
Adrew 
Martin 
USA 


PHP fgets() E25 
定义 和 用 法 

fgets() 函数 从 文件 指针 中 读 取 一 行 。 
语法 


fgets(file, length) 


BR 描述 
file 必需 。 规 定 要 读 取 的 文件 。 
length 可 选 。 规 定 要 读 取 的 字 节 数 。 默 认 是 1024 字 节 。 


说 明 


M file 指向 的 文件 中 读 取 一 行 并 返回 长 度 最 多 为 length - 1 字 节 的 字符 串 。 碰 到 换行 符 (包括 
在 返回 值 中 ) 、EOF 或 者 已 经 读 取 了 length - 1 字 节 后 停止 (要 看 先 磁 到 那 一 种 情况 ) 。 如 
果 没 有 指定 length, WEN 5 1K， 或 者 说 1024 字 节 。 


若 失 败 ， 则 返回 false, 


提示 和 注释 


注释 : length 参数 从 PHP 4.2.0 起 成 为 可 选项 ， 如 果 和 忽略 ， 则 行 的 长 度 被 假定 为 1024 字 节 。 
M PHP 4.3 开始 ， 忽 略 掉 length 将 继续 从 流 中 读 取 数 据 直 到 行 结 束 。 如 果 文 件 中 的 大 多 数 行 
都 大 于 8 KB， 则 在 脚本 中 指定 最 大 行 的 长 度 在 利用 资源 上 更 为 有 效 。 


注释 : M PHP 4.3 开始 本 函数 可 以 安全 用 于 二 进 制 文件 。 早 期 的 版 本 则 不 行 。 


注释 : 如 果 磋 到 PHP 在 读 取 文件 时 不 能 识别 Macintosh 文件 的 行 结束 符 ， 可 以 激活 
auto detect line endings 运行 时 配置 选项 。 


例子 
例子 1 


<?php 

$file - fopen("test.txt","r"); 
echo fgets($file); 
fclose($file); 


?» 


输出 类 似 : 


Hello, this is a test file. 


例子 2 


<?php 
$file - fopen("test.txt","r"); 
while(! feof($file) ) 


{ 
echo fgets($file). "<br />"; 
} 


fclose($file); 
?> 


输出 类 似 : 


Hello, this is a test file. 
There are three lines here. 
This is the last line. 


PHP fgetss() 函数 


— 、 ` 

定义 和 用 法 

fgetss() 画 数 从 打开 的 文件 中 读 取 一 行 并 过 滤 掉 HTML 和 PHP 标记 。 

5 fgets() 相同 ， 不 同 的 是 fgetss 尝试 从 读 取 的 文本 中 去 掉 任 何 HTML 和 PHP 标记 。 


语法 


fgetss( file , length , tags ) 





参数 描述 
file 必需 。 规 定 要 读 取 的 文件 。 
可 选 。 规 定 要 读 取 的 字 节 数 。 默 认 是 1024 字 节 。 该 参数 在 PHP 5 之 前 是 必需 


tags 可 选 。 规 定 不 会 被 删除 的 标签 。 


说 明 
可 以 用 可 选 的 第 三 个 参数 tags 指定 哪些 标记 不 被 去 掉 。 


若 失 败 ， 则 返回 false, 


例子 
例子 1 


<?php 

$file = fopen("test.htm","r"); 
echo fgetss($file); 
fclose($file); 


?> 


输出 类 似 : 


This is a paragraph. 


例子 2 


<?php 


$file - fopen("test.htm","r"); 
echo fgetss($file, 1024, "<p>, <b>"); 
fclose($file); 


?> 


输出 类 似 : 
**This is a paragraph.** 


输出 的 源 代码 是 : 


<p><b>This is a paragraph.</b></p> 


PHP file() 函数 


定义 和 用 法 
file() 函数 把 整个 文件 读 入 一 个 数组 中 。 


5 file get contents() 类 似 ， 不 同 的 是 file) 将 文件 作为 一 个 数组 返回 。 数 组 中 的 每 个 单元 都 
是 文件 中 相应 的 一 行 ， 包 括 换行 符 在 内 。 


如 果 失 败 ， 则 返回 false. 
语法 


file(path, include path, context) 


参数 描述 
path 必需 。 规 定 要 读 取 的 文件 。 
3 XH i 3 Hs NT dE uy 
ks paih a 如 果 也 想 在 include_path 中 搜寻 文件 的 话 ， 可 以 将 该 参数 设 为 
coment 可 选 。 规 定 文 件 句柄 的 环境 。context 是 一 套 可 以 修改 流 的 行为 的 选项 。 
若 使 用 null， 则 忽略 。 
说 明 


对 context 的 支持 是 PHP 5.0.0 添加 的 。 


返回 的 数组 中 每 一 行 都 包括 了 行 结束 符 ， 因 此 如 果 不 需 要 行 结束 符 时 还 需要 使 用 rtrim() EA 
数 。 


提示 和 注释 
注释 : 从 PHP 4.3.0 开始 ， 可 以 用 file get contents() 来 将 文件 读 入 到 一 个 字符 串 并 返回 。 


注释 : 从 PHP 4.3.0 开始 ，file() 可 以 安全 用 于 二 进 制 文件 。 


注释 : 如 果 碰 到 PHP 在 读 取 文 件 时 不 能 识别 Macintosh 文件 的 行 结束 符 ， 可 以 激活 
auto detect line endings 运行 时 配置 选项 。 


例子 


<?php 
print r(file("test.txt")); 
?> 


输出 : 


Array 

( 

[0] => Hello World. Testing testing! 
[1] => Another day, another line. 

[2] => If the array picks up this line, 
[3] => then is it a pickup line? 


) 


PHP file exists() HŽ% 


ris. ` 
file exists() HŽ & X#RE E ERTE. 
如 果 指 定 的 文件 或 目录 存在 则 返回 true， 否 则 返回 false. 


例子 


<?php 
echo file exists("test.txt"), 
?> 


输出 : 


1 


PHP file get contents() 2X 


定义 和 用 法 
file get contents() 函数 把 整个 文件 读 入 一 个 字符 串 中 。 
All file) —#, FAME file get contents() 把 文件 读 入 一 个 字符 串 。 


flo get. contents() 函数 是 用 于 将 文件 的 内 容 读 人 到 一 个 字符 串 中 的 首选 方法 。 如 果 操 作 系统 
支持 ， 还 会 使 用 内 存 映射 技术 来 增强 性 能 。 


语法 


file get contents( path , include path , context , start , max length ) 





参数 描述 
path 必需 。 规 定 要 读 取 的 文件 。 
nclideepath ns 如 果 也 想 在 include path 中 搜寻 文件 的 话 ， 可 以 将 该 参数 设 为 
可 选 。 规 定 文件 句柄 的 环境 。context 是 一 套 可 以 修改 流 的 行为 的 选项 。 
Context 
若 使 用 null， 则 忽略 。 
start 可 选 。 规 定 在 文件 中 开始 读 取 的 位 置 。 该 参数 是 PHP 5.1 新 加 的 。 


max_length 可 选 。 规 定 读 取 的 字 节 数 。 该 参数 是 PHP 5.1 新 加 的 。 
说 明 
对 context 参数 的 支持 是 PHP 5.0.0 添加 的 。 
提示 和 注释 


注释 : 本 加 数 可 安全 用 于 二 进 制 对 象 。 


例子 


<?php 
echo file get contents("test.txt"); 
?> 


W3School PHP 参考 手册 


输出 : 


This is a test file with test text. 


PHP file get contents() 函数 332 


PHP file put contents() 函数 


定义 和 用 法 
file put contents() 函数 把 一 个 字符 串 写 入 文件 中 。 


与 依次 调用 fopen(), fwrite() 以 及 fclose() 功能 一 样 。 
语法 


file put contents(file,data,mode,context) 


参数 描述 
file 必需 。 规 定 要 写 入 数据 的 文件 。 如 果 文 件 不 存在 ， 则 创建 一 个 新 文件 。 


data 可 选 。 规 定 要 写 入 文件 的 数据 。 可 以 是 字符 串 、 数 组 或 数据 流 。 
可 选 。 规 定 如 何 打 开 / 写 入 文件 。 可 能 的 值 : FILE USE INCLUDE PATH 


mode 
FILE APPEND LOCK EX 
可 选 。 规 定 文 件 句 柄 的 环境 。context 是 一 套 可 以 修改 流 的 行为 的 选项 。 若 使 
Context 2 
用 null， 则 忽略 。 
说 明 


参数 data 可 以 是 数组 (但 不 能 是 多 维 数组 ) 。 


A PHP 5.1.0 起 ，data 参数 也 可 以 被 指定 为 stream 资源 ，stream 中 所 保存 的 缓存 数据 将 被 
写 入 到 指定 文件 中 ， 这 种 用 法 就 相似 于 使 用 stream copy to stream() HX. 


对 context 参数 的 支持 是 PHP 5.0.0 添加 的 。 

jx [n] (à 

Z ERBCREG [B] 5 A EIHAR E 7 RK 
提示 和 注释 

提示 : 使 用 FILE_APPEND 可 避免 删除 文件 中 已 有 的 内 容 。 
注释 : 本 本 数 可 安全 用 于 二 进 制 对 象 。 


例子 


<?php 
pene file put contents("test.txt", "Hello World. Testing!"); 
?> 


输出 : 


26 


PHP fileatime() 函数 


ra. $ 
fileatime() 范 数 返回 指定 文件 的 上 次 访问 时 间 。 
该 范 数 返回 文件 上 次 被 访问 的 时 间 。 如 果 出 错 则 返回 false。 时 间 以 Unix it ja) BRAY ak 


fileatime( filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 

提示 : 本 画 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 

注释 : 文件 的 atime 应 该 在 不 论 何 时 读 取 了 该 文件 中 的 数据 块 时 被 更 改 。 当 一 个 应 用 程序 定 
期 访问 大 量 文件 或 目录 时 很 影响 性 能 。 有 些 Unix 文件 系统 可 以 在 加 载 时 关闭 atime 的 更 新 以 


提高 这 类 程序 的 性 能 。USENET 新 闻 组 假 脱 机 是 一 个 常见 的 例子 。 在 这 种 文件 系统 下 ， 本 画 
数 没有 用 处 。 


例子 


<?php 

echo fileatime("test.txt"); 

echo "Last access: ".date("F d Y H:i:s.",fileatime("test.txt")); 
?> 


输出 : 


1140684501 
Last access: February 23 2006 09:48:21. 


PHP filectime() 函数 


定义 和 用 法 
filectime() 函数 返回 指定 文件 的 上 次 inode 修改 时 间 。 


该 函数 返回 文件 上 次 inode 被 修改 的 时 间 。 如 果 出 错 则 返回 false。 时 间 以 Unix s4 ANA 
式 返 回 。 


语法 


fileatime( filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 
提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


注意 : 在 大 多 数 Unix 文件 系统 中 ， 当 一 个 文件 的 inode 数据 被 改变 时 则 该 文件 被 认为 是 修改 
了 。 也 就 是 说 ， 当 文件 的 权限 ， 所 有 者 ， 所 有 组 或 其 它 inode 中 的 元 数据 被 更 新 时 。 参 见 
filemtime()( 这 才 是 你 想 用 于 在 Web 页 面 中 建立 “最 后 更 新 时 间 " 脚 注 的 函数 ) 和 fileatime()。 


注释 : 某 些 Unix 说 明文 本 中 把 ctime 说 成 是 该 文件 建立 的 时 间 ， 这 是 错 的 。 在 大 多 数 Unix 
文件 系统 中 ， 没 有 Unix 文件 的 建立 时 间 。 


例子 


<?php 

echo filectime("test.txt"), 

echo "Last change: ".date("F d Y H:i:s.",filectime("test.txt")); 
?> 


输出 : 


1138609592 
Last change: January 30 2006 09:26:32. 


PHP filegroup() 函数 


定义 和 用 法 
filegroup() 汞 数 返 回 指定 文件 的 组 ID. 


若 成 功 ， 则 返回 指定 文件 所 属 组 的 ID。 若 失败 ， 则 返回 false 以 及 一 个 E_WARNING 级 别 的 


4 ko 


组 ID 以 数字 格式 返回 。 


语法 
filegroup(filename ) 
参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 
提示 : 本 画 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


提示 : 请 使 用 posix getgrgid() 来 将 组 ID 转换 为 组 名 。 


例子 


<?php 
echo filegroup("test.txt"); 
?> 


PHP fileinode() E325 


定义 和 用 法 
fileinode() 画 数 返回 文件 的 inode 编号 。 


若 成 功 ， 则 返回 指定 文件 的 inode 节点 号 。 若 失败 ， 则 返回 false. 


fileinode(filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 
提示 和 注释 


提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
echo fileinode("test.txt"); 
?> 


PHP filemtime() 函数 


rm. N 
filemtime() HÄR EONA Z E ZR B 4E C iR] 
若 成 功 ， 则 时 间 以 Unix et jg BBJ OE. FA, WIRE false. 


filemtime(filename ) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


说 明 
本 画 数 返回 文件 中 的 数据 块 上 次 被 宇 入 的 时 间 ， 也 就 是 说 ， 文 件 的 内 容 上 次 被 修改 的 时 间 。 
提示 和 注释 


提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 

echo filemtime("test.txt"); 

echo "Last modified: ".date("F d Y H:i:s.",filemtime("test.txt")); 
?> 


输出 : 


1139919766 
Last modified: February 14 2006 13:22:46. 


PHP fileowner() HŽ% 


定义 和 用 法 
fileowner() 函数 返回 文件 的 所 有 者 。 
若 成 功 ， 则 返回 文件 所 有 的 用 户 ID。 若 失败 ， 则 返回 false, Až ID 以 数字 格式 返回 。 


fileowner(filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 
提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


提示 : 用 户 ID 以 数字 格式 返回 ， 请 使 用 posix getpwuid() 来 把 用 户 ID 转换 为 用 户 名 。 


例子 


<?php 
echo fileowner("test.txt"); 
?> 


PHP fileperms() 函数 


= ~ i 
fileperms() EAŽOREJMf4 e E] RAJ BS 
若 成 功 ， 则 返回 文件 的 访问 权限 。 若 失败 ， 则 返回 false. 


fileperms(filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 


提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 
例子 1 


<?php 
echo fileperms("test.txt"); 
?> 


输出 : 


33206 


例子 2 
以 八进制 值 返回 权限 : 


<?php 
echo substr(sprintf("%o",fileperms("test.txt")), -4); 
?> 


W3School PHP 参考 手册 


输出 : 


1777 


PHP fileperms() 函数 342 


PHP filesize() HŽ% 


定义 和 用 法 
filesize() 函数 返回 指定 文件 的 大 小 。 


若 成 功 ， 则 返回 文件 大 小 的 字 节 数 。 若 失败 ， 则 返回 false 并 生成 一 条 E. WARNING 级 的 错 


“器 
IRo 


语法 
filesize(filename) 
BR 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 


提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
echo filesize("test.txt"); 
?> 


输出 : 


20 


PHP filetype() E325 


定义 和 用 法 
filetype() 函数 返回 指定 文件 或 目录 的 类 型 。 


若 成 功 ， 则 返回 7 种 可 能 的 值 。 若 失败 ， 则 返回 false。 


e fifo 

e char 

e dir 

e block 

e link 

e file 

e unknown 


语法 
filetype(filename) 


参数 描述 
filename 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 

提示 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 
例子 

例子 1 


<?php 
echo filetype("test.txt"), 
?> 


输出 : 


file 


例子 2 


<?php 
echo filetype("images"); 
?> 


输出 : 


dir 


PHP flock() 函数 


定义 和 用 法 
flock() 函数 锁定 或 释放 文件 。 
若 成 功 ， 则 返回 true。 若 失败 ， 则 返回 false. 


语法 


flock(file,lock,block) 


file 必需 。 规 定 要 锁定 或 释放 的 已 打开 的 文件 。 
lock 必需 。 规 定 要 使 用 哪 种 锁定 类 型 。 

block 可 选 。 若 设置 为 1 或 true， 则 当 进 

说 明 


flock() 操作 的 file 必须 是 一 个 已 经 打开 的 文件 指针 。 
lock 参数 可 以 是 以 下 值 之 一 : 


。 要 取得 共享 锁定 〈 读 取 的 程序 ) ， 
为 1) 。 

。 要 取得 独占 锁定 ( 写 入 的 程序 ) , 
置 为 2) 。 

bs 要 释放 锁定 (无 论 共 
EX 3). 


tz X»), 


e 如 果 不 希望 flock() 在 锁定 时 堵塞 ， 则 给 lock 加 上 LOCK NB (PHP 4.0.1 以 前 的 版 本 中 


设置 为 4) 。 


提示 和 注释 
提示 : 可 以 通过 fclose() 来 释放 锁定 操作 ， 代 码 执行 
注释 : 由 于 flock() 需要 一 


井 行 锁定 时 阻挡 其 他 进程 。 


将 lock 设 为 LOCK_SH (PHP 4.0.1 以 前 的 版 本 设置 
将 lock 设 为 LOCK_EX (PHP 4.0.1 以 前 的 版 本 中 设 


将 lock 设 为 LOCK_UN (PHP 4.0.1 以 前 的 版 本 中 设 


了 完毕 时 也 会 自动 调用 。 


个 文件 指针 ， 因此 可 能 不 得 不 用 一 个 特殊 的 锁定 文件 来 保护 打算 通 
过 写 模式 打开 的 文件 的 访问 (在 fopen() 函数 中 加 入 "w" 


或 "w+") o 


例子 


<?php 
$file = fopen("test.txt","w+"), 


// 排 它 性 的 锁定 
if (flock($file,LOCK EX)) 


fwrite($file, "Write something"); 
// release lock 
flock($file,LOCK UN); 

J 


else 


t 


echo "Error locking file!"; 


} 
fclose($file); 
?> 


PHP fnmatch() 2% 
定义 和 用 法 

fnmatch() 函数 根据 指定 的 模式 来 匹配 文件 名 或 字符 串 。 
语法 


fnmatch(pattern, string, flags) 


参数 描述 
pattern 必需 。 规 定 要 检索 的 模式 。 
string 必需 。 规 定 要 检查 的 字符 串 或 文件 。 
flags 可 选 。 


说 明 


此 函数 对 于 文件 名 尤其 有 用 ， 但 也 可 以 用 于 普通 的 字符 串 。 普 通用 户 可 能 习惯 于 shell 模式 或 
者 至 少 其 中 最 简单 的 形式 '?' 和 "” 通配符， 因此 使 用 fnmatch() KRE ereg() 或 者 
preg match() 来 进行 前 端 搜索 表达 式 输入 对 于 非 程序 员 用 户 更 加 方便 。 


提示 和 注释 


重要 事项 : 目前 该 了 本数 无 法 在 Windows 或 其 它 非 POSIX 兼容 的 系统 上 使 用 。 


例子 
根据 shell 通配符 来 检查 颜色 名 : 


<?php 
$txt = "My car is darkgrey..." 
if (fnmatch("*gr[ae]y",$txt)) 


echo "some form of gray ..."; 


J 


?> 


PHP fopen() E325 


定义 和 用 法 
fopen() 函数 打开 文件 或 者 URL. 
WRIT A Am, AARRE] FALSE. 


语法 


fopen(filename, mode, include path, context) 


参数 描述 
filename 必需 。 规 定 要 打开 的 文件 或 URL. 
mode 必需 。 规 定 要 求 到 该 文件 / 流 的 访问 类 型 。 可 能 的 值 见 下 表 。 
el tl n END include path 中 检索 文件 的 话 ， 可 以 将 该 参数 设 为 


E 
context 可 选 。 规 定 文 件 句柄 的 环境 。Context 是 可 以 修改 流 的 行为 的 一 套 选 项 。 


mode 参数 的 可 能 的 值 


mode 说 明 

hp 只 读 方式 打开 ， 将 文件 指针 指向 文件 头 。 

"r+" 读 写 方式 打开 ， 将 文件 指针 指向 文件 头 。 

写 入 方式 打开 ， 将 文件 指针 指向 文件 头 并 将 文件 大 小 截 为 需 。 如 果 文 件 不 存在 
则 尝试 创建 之 。 

读 写 方式 打开 ， 将 文件 指针 指向 文件 头 并 将 文件 大 小 截 为 需 。 如 果 文件 不 存在 
则 尝试 创建 之 。 

"a" 写 入 方式 打开 ， 将 文件 指针 指向 文件 末尾 。 如 果 文 件 不 存在 则 尝试 创建 之 。 
"ar" 读 写 方式 打开 ， 将 文件 指针 指向 文件 末尾 。 如 果 文 件 不 存在 则 党 试 创 建 之 。 


创建 并 以 写 入 方式 打开 ， 将 文件 指针 指向 文件 头 。 如 果 文 件 已 存在 ， 则 fopen() 
调用 失败 并 返回 FALSE， 并 生成 一 条 E WARNING 级 别 的 错误 信息 。 如 果 文 

"x" 件 不 存在 则 党 试 创建 之 。 这 和 给 底层 的 open(2) 系统 调用 指定 
O_EXCLIO_CREAT 标记 是 等 价 的 。 此 选项 被 PHP 4.3.2 以 及 以 后 的 版 本 所 支 
持 ， 仅 能 用 于 本 地 文件 。 


创建 并 以 读 写 方 式 打 开 ， 将 文件 指针 指向 文件 头 。 如 果 文 件 已 存在 ， 则 fopen() 
调用 失败 并 返回 FALSE， 并 生成 一 条 E WARNING 级 别 的 错误 信息 。 如 果 文 

"x+" 件 不 存在 则 党 试 创建 之 。 这 和 给 底层 的 open(2) 系统 调用 指定 
O_EXCLIO_CREAT 标记 是 等 价 的 。 此 选项 被 PHP 4.3.2 以 及 以 后 的 版 本 所 支 
持 ， 仅 能 用 于 本 地 文件 。 


说 明 

fopen() 将 filename 指定 的 名 字 资 源 绑 定 到 一 个 流 上 。 如 果 filename = "scheme.//..." 的 格 

式 ， 则 被 当成 一 个 URL, PHP 将 搜索 协议 处 理 器 (也 被 称 为 封装 协议 ) 来 处 理 此 模式 。 如 果 
该 协议 尚未 注册 封装 协议 ，PHP 将 发 出 一 条 消息 来 帮助 检查 脚本 中 潜在 的 问题 并 将 filename 
当成 一 个 普通 的 文件 名 继续 执行 下 去 。 


如 果 PHP 认为 flename 指定 的 是 一 个 本 地 文件 ， 将 尝试 在 该 文件 上 打开 一 个 流 。 该 文件 必须 
是 PHP 可 以 访问 的 ， 因 此 需要 确认 文件 访问 权限 允许 该 访问 。 如 果 激 活 了 安全 模式 或 者 
open_basedir 则 会 应 用 进一步 的 限制 。 

如 果 PHP 认为 filename 指定 的 是 一 个 已 注册 的 协议 ， 而 该 协议 被 注册 为 一 个 网 络 URL, 
PHP 将 检查 并 确认 allow_url_fopen 已 被 激活 。 如 果 关 闭 了 ，PHP 将 发 出 一 个 警告 ， 而 
fopen 的 调用 则 失败 。 


对 context 的 支持 是 PHP 5.0.0 添加 的 。 


提示 和 注释 


注释 : 不 同 的 操作 系统 家 族 具 有 不 同 的 行 结束 习惯 。 当 写 入 一 个 文本 文件 并 想 插 入 一 个 新 行 
时 ， 需 要 使 用 符合 操作 系统 的 行 结束 符号 。 基 于 Unix 的 系统 使 用 \n 作为 行 结束 字符 ， 基 于 
Windows 的 系统 使 用 WW 作为 行 结束 字符 ， 基 于 Macintosh 的 系统 使 用 V 作为 行 结束 字符 。 
如 果 写 入 文件 时 使 用 了 错误 的 行 结束 符号 ， 则 其 它 应 用 程序 打开 这 些 文件 时 可 能 会 表现 得 很 


怪异 。 


Windows 下 提供 了 一 个 文本 转换 标记 〈"t") 可 以 透明 地 将 \n 转换 为 Wn. Sib xt s xe n ELS 
用 "b" 来 强制 使 用 二 进 制 模式 ， 这 样 就 不 会 转换 数据 。 要 使 用 这 些 标记 ， 要 么 用 "b" 或 者 用 U 
作为 mode 参数 的 最 后 一 个 字符 。 


默认 的 转换 模式 依赖 于 SAPI 和 所 使 用 的 PHP 版 本 ， 因 此 为 了 便于 移植 鼓励 总 是 指定 恰当 的 
标记 。 如 果 是 操作 纯 文 本 文件 并 在 脚本 中 使 用 了 \n 作为 行 结束 符 ， 但 还 要 期 望 这 些 文件 可 以 
被 其 它 应 用 程序 例如 Notepad 读 取 ， 则 在 mode 中 使 用 "t"。 在 所 有 其 它 情况 下 使 用 "b" 


在 操作 二 进 制 文件 时 如 果 没 有 指定 "b" 标记 ， 可 能 会 磁 到 一 些 奇怪 的 问题 ， 包 括 坏 掉 的 图 片 文 
件 以 及 关于 Win 字符 的 奇怪 问题 。 


注释 : 为 移植 性 考虑 ， 强 烈 建 议 在 用 fopen() 打开 文件 时 总 是 使 用 "b" 标记 。 


注释 : 再 一 次 ， 为 移植 性 考虑 ， 强 烈 建议 你 重 写 那 些 依赖 于 "t" 模式 的 代码 使 其 使 用 正确 的 行 
结束 符 并 改 成 "b" 模式 。 


例子 


<?php 

$file = fopen("test.txt","r"); 

$file = fopen("/home/test/test.txt","r"); 

$file = fopen("/home/test/test.gif","wb"); 

$file = fopen("http://www.example.com/","r"); 

$file = fopen("ftp://user:passwordQexample.com/test.txt", "w"); 
?> 


PHP fpassthru() Až 


定义 和 用 法 
fpassthru() 函数 输出 文件 指针 处 的 所 有 剩余 数据 。 


该 图 数 将 给 定 的 文件 指针 从 当前 的 位 置 渎 取 到 EOF， 并 把 结果 写 到 输出 缓冲 区 。 


fpassthru(file) 


参数 描述 
file 必需 。 规 定 要 读 取 的 打开 文件 或 资源 。 


说 明 
如 果 发 生 错误 ， fpassthru() 返回 false. An] fpassthru() 返回 从 file 读 取 并 传递 到 输出 的 字符 
数目 。 


文件 指针 必须 有 效 ， 并 且 必 须 指向 一 个 由 fopen() 或 fsockopen() 成 功 打开 (但 还 没有 被 
fclose() 关闭 ) 的 文件 。 


提示 和 注释 
提示 : 如 果 已 经 向 文件 写 入 数据 ， 就 必须 调用 rewind) 来 将 文件 指针 指向 文件 头 。 


提示 : 如 果 既 不 修改 文件 也 不 在 特定 位 置 检索 ， 只 想 将 文件 的 内 容 下 载 到 输出 缓冲 区 ， 应 该 
使 用 readfile()， 这 样 可 以 省 去 fopen() 调用 。 


注释 : 当 在 Windows 系统 中 将 fpassthru() 用 于 二 进 制 文件 时 ， 要 确保 在 用 fopen() 打开 文件 
时 在 mode 中 附加 了 b 来 将 文件 以 二 进 制 方式 打开 。 鼓 励 在 处 理 二 进 制 文件 时 使 用 b 标志 ， 
即使 系统 并 不 需要 ， 这 样 可 以 使 脚本 的 移植 性 更 好 。 


例子 
例子 1 


<?php 
$file - fopen("test.txt","r"); 


// 读 取 第 一 行 
fgets($file), 


// 把 文件 的 其 余部 分 发 送 到 输出 缓存 
echo fpassthru($file); 


fclose($file); 
?> 


输出 : 


There are three lines in this file. 
This is the last line.59 


È : 59 指示 被 传递 的 字符 数 。 


例子 2 
转 储 www 服务 器 的 index 页 : 


<?php 

$file = fopen("http://www.example.com","r"); 
fpassthru($file); 

?> 


PHP fputcsv() HŽ% 


rm . 3 
fputcsv() PgZi EET TR EZ; CSV 并 写 入 一 个 打开 的 文件 。 
该 贺 数 返回 守 入 字符 串 的 长 度 。 若 出 错 ， 则 返回 false。。 


fputcsv(file, fields, seperator, enclosure) 





参数 描述 
file 必需 。 规 定 要 写 入 的 打开 文件 。 
fields 必需 。 规 定 要 从 中 获得 数据 的 数组 。 
seperator 可 选 。 规 定 字段 分 隔 符 的 字符 。 默 认 是 喜 号 (,)。 
enclosure 可 选 。 规 定 字段 环绕 符 的 字符 。 默 认 是 双 引 号 "。 
说 明 


fputcsv() 将 一 行 (用 fields 数组 传递 ) 格式 化 为 CSV 格式 并 写 入 由 file 指定 的 文件 。 


提示 和 注释 
提示 : 参见 fgetcsv() WRX. 


例子 


<?php 
$list - array 


"George, John, Thomas, USA", 
"James, Adrew, Martin, USA", 
$file = fopen("contacts.csv","w"); 


foreach ($list as $line) 


{ 
fputcsv($file,split(',',$line)); 


fclose($file); 
?> 


以 上 代码 执行 后 ，CSV 文件 会 类 似 这 样 : 


George, John, Thomas, USA 
James, Adrew, Martin, USA 


PHP fputs() HŽ% 


定义 和 用 法 


fputs() 函数 写 入 文件 (可 安全 用 于 二 进 制 文件 ) 。 
fputs() 函数 是 fwrite) RELAY $145, 
语法 


fputs(file,string, length) 


参数 描述 
file 必需 。 规 定 要 写 入 的 打开 文件 。 
string 必需 。 规 定 要 写 入 文件 的 字符 串 。 
length 可 选 。 规 定 要 写 入 的 最 大 字 节 数 。 
说 明 


fwrite() 把 string 的 内 容 写 入 文件 指针 file a. 如 果 指 定 了 /length， 当 写 入 了 length 个 字 节 或 
者 写 完 了 string 以 后 ， 写 入 就 会 停止 ， 视 平 先 碰 到 哪 种 情况 。 


fwrite() 返回 守 入 的 字符 数 ， 出 现 错误 时 则 返回 false, 


例子 


<?php 

$file = fopen("test.txt","w"); 

echo fputs($file, "Hello World. Testing!"); 
fclose($file); 

?> 


输出 : 


21 


PHP fread() 函数 


定义 和 用 法 


fread() 函数 读 取 文 件 〈 可 安全 用 于 二 进 制 文件 ) 。 


语法 
fread(file, length) 
参数 描述 
file 必需 。 规 定 要 读 取 打开 文件 。 
length 必需 。 规 定 要 读 取 的 最 大 字 节 数 。 
说 明 


fread() 从 文件 指针 file 读 取 最 多 length SEF. ZRA RERS length 个 字 节 数 ， 或 到 
达 EOF 的 时 候 ， 或 (对 于 网 络 流 ) 当 一 个 包 可 用 时 ， 或 (在 打开 用 户 空间 流 之 后 ) 已 读 取 了 
8192 个 字 节 时 就 会 停止 读 取 文 件 ， 视 乎 先 磁 到 哪 种 情况 。 


返回 所 读 取 的 字符 串 ， 如 果 出 错 返 回 false。 


提示 和 注释 


提示 : 如 果 只 是 想 将 一 个 文件 的 内 容 读 人 到 一 个 字符 串 中 ， 请 使 用 file get_contents()， 它 的 
性 能 比 fread() 好 得 多 。 


例子 
例子 1 


从 文件 中 读 取 10 个 字 节 : 


<?php 

$file = fopen("test.txt","r"); 
fread($file, "10"), 
fclose($file); 

?> 


例子 2 
读 取 整 个 文件 : 


<?php 

$file = fopen("test.txt","r"); 
fread($file, filesize("test.txt")); 
fclose($file); 

?> 


PHP fscanf() 函数 

定义 和 用 法 

fscanf() 画 数 根据 指定 的 格式 对 来 自打 开 的 文件 的 给 入 进行 解析 。 
语法 


fscanf(file, format,mixed) 


参数 描述 
file 必需 。 规 定 要 检查 的 文件 。 
format 必需 。 规 定格 式 。 
mixed 可 选 。 


说 明 


fscanf() HAS sscanf() 相似 ， 但 是 它 从 与 je 关联 的 文件 中 接受 输入 并 根据 指定 的 format 来 
解释 输入 。 如 果 只 给 此 本 数 传 递 了 两 个 参数 ， 解 析 后 的 值 会 被 作为 数组 返回 。 否 则 ， 如 果 提 
供 了 可 选 参 数 ， 此 函数 将 返回 被 赋值 的 数目 。 可 选 参 数 必须 用 引用 传递 。 


提示 和 注释 
a 这 意味 着 甚至 格式 字符 串 中 
的 制 表 符 Vt 也 会 与 输入 流 中 的 一 个 空格 字符 匹配 。 


注释 : 在 PHP 4.3.0 之 前 ， 从 文件 中 读 人 的 最 大 字符 数 是 512 (或 者 第 一 个 m， 看 先 碰 到 哪 
种 情况 ) © M PHP 4.3.0 起 可 以 读 取 任 意 长 的 行 。 


PHP fseek() EX 


定义 和 用 法 
fseek() 本 数 在 打开 的 文件 中 定位 。 
该 函数 把 文件 指针 从 当前 位 置 向 前 或 向 后 移动 到 新 的 位 置 ， 新 位 置 从 文件 头 开 始 以 字 节 数 度 


量 。 
成 功 则 返回 0 ; 否则 返回 -1。 注 意 ， 移 动 到 EOF 之 后 的 位 置 不 会 产生 错误 。 
语法 
fseek(file,offset,whence) 
参数 描述 
file 必需 。 规 定 要 在 其 中 定位 的 文件 。 


offset 必需 。 规 定 新 的 位 置 〈 从 文件 头 开始 以 字 节 数 度量 ) 。 


可 选 。 可 能 的 值 : SEEK SET - 设 定 位 置 等 于 offset 字 节 。 默 认 。 SEEK CUR 
whence - 设 定位 置 为 当前 位 置 加 上 offset, SEEKEND - 设 定位 置 为 文件 末尾 加 上 
offset (要 移动 到 文件 尾 之 前 的 位 置 ，offset 必须 是 一 个 负 值 ) 。 


说 明 
whence 参数 是 PHP 4.0.0 之 后 增加 的 。 
提示 和 注释 


提示 : 通过 使 用 ftell() 来 找到 当前 位 置 。 


例子 


<?php 
$file - fopen("test.txt","r"); 


// 读 取 第 一 行 
fgets($file); 


// 倒 回 文件 的 开头 
fseek($file,0); 
?> 


PHP fstat() 函数 


Sm 、 i 
fstat() 函数 返回 关于 打开 文件 的 信息 。 
语法 
fstat(file) 
参数 描述 
pipe 必需 。 规 定 要 检查 的 打开 文件 。 
说 明 


获取 由 文件 指针 handle 所 打开 文件 的 统计 信息 。 
该 范 数 返 回 的 数组 具有 该 文件 的 统计 信息 ， 该 数组 包含 以 下 元 素 : 


数字 下 标 关联 键 名 (A PHP 4.0.6) 说 明 

0 dev 设备 名 

1 ino 54 

2 mode inode 保护 模式 

3 nlink 被 连接 数目 

4 uid 所 有 者 的 用 户 id 

5 gid 所 有 者 的 组 id 

6 rdev 设备 类 型 ， 如 果 是 inode 设备 的 话 
Y size 文件 大 小 的 字 节 数 

8 atime 上 次 访问 时 间 (Unix a£ ja] Zh) 
9 mtime 上 次 修改 时 间 (Unix st ja ) 
10 ctime 上 次 改变 时 间 (Unix a£ ja] Be) 
11 blksize 文件 系统 IO 的 块 大 小 


12 blocks 所 占据 块 的 数目 


提示 和 注释 


提示 : AAS stat() 画 数 相似 ， 不 同 的 是 ， 它 是 作用 于 已 打开 的 文件 指针 而 不 是 文件 名 。 


例子 


<?php 
$file = fopen("test.txt","r"); 
print r(fstat($file)), 


fclose($file); 
?> 
输出 类 似 : 
Array 
( 
[0] => 0 
[1] => 0 
[2] => 33206 
[3] => 1 
[4] => 0 
[5] => 0 
[6] => 0 
[7] => 92 


[8] => 1141633430 
[9] => 1141298003 
[10] => 1138609592 


[11] => -1 
[12] > 1 
[dev] => 0 


[ino] => 0 
[mode] => 33206 
[nlink] => 1 


[uid] => 0 
[gid] => 0 
[rdev] => 0 


[size] => 92 

[atime] => 1141633430 
[mtime] => 1141298003 
[ctime] => 1138609592 
[blksize] => -1 
[blocks] => -1 

) 


PHP ftell() E25 


定义 和 用 法 
ftell() 函数 在 打开 文件 中 的 当前 位 置 。 
该 函数 返回 文件 指针 的 当前 位 置 。 若 失败 ， 则 返回 false, 


语法 
ftell(file) 
参数 描述 
file 必需 。 规 定 要 检查 的 已 打开 文件 。 
说 明 


文件 指针 file 必须 是 有 效 的 ， 且 必须 指向 一 个 通过 fopen() 或 popen() 成 功 打 开 的 文件 。 
在 附加 模式 (加 参数 "a" 打开 文件 ) 中 ftell() 会 返回 未 定义 错误 。 


例子 


<?php 
$file = fopen("test.txt","r"); 


// 输出 当前 位 置 
echo ftell($file); 





// 改变 当前 位 置 
fseek($file, "15"), 


// 再 次 输出 当前 位 置 
echo ftell($file); 


fclose($file); 
?> 


PHP ftruncate() 函数 
定义 和 用 法 

ftruncate() 函数 把 文件 截断 到 指定 的 长 度 。 
语法 


ftruncate(file, size) 


参数 描述 
file 必需 。 规 定 要 截断 的 打开 文件 。 
size 必需 。 规 定 新 的 文件 大 小 。 
说 明 


接受 文件 指针 file 作为 参数 ， 并 将 文件 大 小 截取 为 size。 如 果 成 功 则 返回 TRUE， 否则 返回 
FALSE。 


提示 和 注释 
注释 : 文件 只 会 在 append 模式 下 改变 。 在 write 模式 下 ， 必 须 加 上 fseek() 操作 。 


注释 : 在 PHP 4.3.3 之 前 ，ftruncate() 在 成 功 时 返回 一 个 整数 值 1， 而 不 是 布尔 值 的 TRUE。 


例子 


<?ph 

/检查 文件 大 小 

echo filesize("test.txt"), 
echo "<br /»"; 


$file = fopen("test.txt", "a+"), 
ftruncate($file, 100) ; 
fclose($file); 





// 清 空 缓存 ， 再 次 检查 文件 大 小 
clearstatcache(), 

echo filesize("test.txt"), 
?> 
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输出 类 似 : 


792 
100 


PHP ftruncate() E32 366 


PHP fwrite() 函数 
定义 和 用 法 

fwrite() 画 数 写 入 文件 (可 安全 用 于 二 进 制 文件 ) 。 
语法 


fwrite(file, string, length) 


参数 描述 
file 必需 。 规 定 要 写 入 的 打开 文件 。 
string 必需 。 规 定 要 写 入 文件 的 字符 串 。 
length 可 选 。 规 定 要 写 入 的 最 大 字 节 数 。 


说 明 


fwrite() 把 string 的 内 容 写 入 文件 指针 file 处 。 如 果 指 定 了 length, ABAT length 个 字 节 或 
者 写 完 了 string 以 后 ， 写 入 就 会 停止 ， 视 平 先 碰 到 哪 种 情况 。 


fwrite() 返回 写 入 的 字符 数 ， 出 现 错误 时 则 返回 false, 


例子 


<?php 

$file - fopen("test.txt" 

echo fwrite($file,' "Hello. SEN Testing!"); 
fclose($file); 

?> 


输出 : 
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PHP glob() Bižk 


mio. 1 
glob() 函数 返回 匹配 指定 模式 的 文件 名 或 目录 。 
该 范 数 返 回 一 个 包含 有 匹配 文件 / 目录 的 数组 。 如 果 出 错 返 回 false. 


语法 
glob(pattern, flags) 
2 Sa 


file 必需 。 规 定 检索 模式 。 


可 选 。 规 定 特殊 的 设 定 。  GLOB MARK - 在 每 个 返回 的 项 目 中 加 一 个 斜 线 

eLoB NosoRT - 按照 文件 在 目录 中 出 现 的 原始 顺序 返回 (不 排序 ) GLOB NOCHECK 
E - 如 果 没 有 文件 匹配 则 返回 用 于 搜索 的 模式 GLOB NOESCAPE - 反 斜 线 不 转 义 元 字符 

GLOB BRACE -扩充 {a,b,c} 来 匹配 a, b 或 'c' GLOB ONLYDIR - 仅 返 回 与 模式 匹 

配 的 目录 项 GLOB_ERR - 停止 并 读 取 错误 信息 〈 比 如 说 不 可 读 的 目录 ) ， 默 认 的 情 

况 下 忽略 所 有 错误 注释 : GLOB ERR 是 PHP 5.1 添加 的 。 


例子 
例子 1 


<?php 
print r(glob("*.txt")); 
?> 


输出 类 似 : 


[0] => target.txt 
[1] => source.txt 
[2] => test.txt 
[3] => test2.txt 


例子 2 


<?php 
print r(glob("*.*")); 
?> 


输出 类 似 : 


[0] => contacts.csv 
[1] => default.php 
[2] => target.txt 
[3] => source.txt 
[4] => tem1.tmp 

[5] => test.htm 

[6] => test.ini 

[7] => test.php 

[8] => test.txt 

[9] => test2.txt 


PHP is dir() HŽ 
定义 和 用 法 

is dir() 本 数 检查 指定 的 文件 是 否 是 目录 。 
语法 


is_dir(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 名 存在 并 且 为 目录 ， 则 返回 true。 如 果 file 是 一 个 相对 路 径 ， 则 按照 当前 工作 目录 检 
查 其 相对 路 径 。 


提示 和 注释 


注释 : 本 画 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
$file = "images", 
if(is_dir($file) ) 

echo ("$file is a directory"); 
else 


echo ("$file is not a directory"); 


?> 


输出 : 


images is a directory 


PHP is executable() HŽ% 
定义 和 用 法 

is executable() HA AEM MESA A IAT. 
语法 


is executable(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 存在 且 可 执行 ， 则 返回 true, 


提示 和 注释 
注释 : 本 画 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


注释 : is executable() A PHP 5.0.0 版 起 可 用 于 Windows. 


例子 


<?php 
$file - "setup.exe", 
if(is executable($file)) 


echo ("$file is executable"); 
J 
else 
echo ("$file is not executable"); 


} 


?> 


输出 : 


setup.exe is executable 


PHP is file() 函数 


定义 和 用 法 


is file() 范 数 检查 指定 的 文件 名 是 否 是 正常 的 文件 。 


A 


语法 


is file(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 存在 且 为 正常 的 文件 ， 则 返回 true。 


提示 和 注释 


注释 : 本 男 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 
例子 1 


<?php 
$file - "test.txt"; 
if(is_file($file) ) 
echo ("$file is a regular file"); 
else 
echo ("$file is not a regular file"); 


} 


?> 


输出 : 


test.txt is a regular file 


例子 2 


<?php 

var dump(is file('a file.txt')) . "An", 
var dump(is file('/usr/bin/')) . "An", 
?> 


输出 : 


bool(true) 
bool(false) 


PHP is link() HŽ% 


定义 和 用 法 


is_link() 本 数 判断 指定 文件 名 是 否 为 一 个 符号 连接 。 


is link(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 存在 并 且 是 一 个 符号 连接 ， 则 返回 true。 


提示 和 注释 


注释 : RRRA RRRA. AEA clearstatcache() 来 清除 缓存 。 


例子 


<?php 
$link = "images"; 
if(is link($link)) 
{ 
echo ("$link is a link"); 
else 


echo ("$link is not a link"); 


?> 


输出 : 


images is not a link 


PHP is readable() HŽ% 
定义 和 用 法 

is readable() 画 数 判 断 指定 文件 名 是 否 可 读 。 
语法 


is readable(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 由 file 指定 的 文件 或 目录 存在 并 且 可 读 ， 则 返回 TRUE. 


提示 和 注释 


注释 : 本 男 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
SHELL — test tt 
if(is_readable($file)) 


echo ("$file is readable"); 


} 


else 
echo ("$file is not readable"); 


} 


?> 


test.txt is readable 


PHP is uploaded file() HŽ% 


EE : 

is uploaded file() 函数 判断 指定 的 文件 是 否 是 通过 HTTP POST 上 传 的 。 
语法 

is uploaded file(file) 

file 必需 。 规 定 要 检查 的 文件 。 

说 明 

如 果 file 所 给 出 的 文件 是 通过 HTTP POST 上 传 的 则 返回 TRUE。 


该 函数 可 以 用 于 确保 恶意 的 用 户 无 法 欺骗 脚本 去 访问 本 不 能 访问 的 文件 ， 例 如 /etc/passwd。 


这 种 检查 显得 格外 重要 ， 如 果 上 传 的 文件 有 可 能 会 造成 对 用 户 或 本 系统 的 其 他 用 户 显示 其 内 
容 的 话 。 


提示 和 注释 


注释 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
Stale = tesEe tt 
if(is uploaded file($file)) 
echo ("$file is uploaded via HTTP POST"), 


else 


{ 
echo ("$file is not uploaded via HTTP POST"); 


输出 : 
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test.txt is not uploaded via HTTP POST 


PHP is uploaded file() HX 377 


PHP is writable() EX2WK 
定义 和 用 法 

is writable() 函数 判断 指定 的 文件 是 否 可 写 。 
语法 


is writable(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 存在 并 且 可 写 则 返回 true, file 参数 可 以 是 一 个 允许 进行 是 否 可 写 检 查 的 目录 名 。 


提示 和 注释 


注释 : 本 男 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
SELIE — test tt 
if(is_writable($file)) 


echo ("$file is writeable"); 


} 


else 
echo ("$file is not writeable"); 


} 


?> 


test.txt is writeable 


PHP is writeable() HŽ% 


定义 和 用 法 
is writeable() 函数 判断 指定 的 文件 是 否 可 写 。 


IA PANE is writable() HAHN 41 A. 


语法 


is writeable(file) 


file 必需 。 规 定 要 检查 的 文件 。 


说 明 


如 果 文 件 存在 并 且 可 写 则 返回 true, file 参数 可 以 是 一 个 允许 进行 是 否 可 写 检 查 的 目录 名 。 


提示 和 注释 


注释 : 本 男 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
Spe — SIEESE Ext 
if(is writeable($file)) 


echo ("$file is writeable"); 
J 
else 
echo ("$file is not writeable"), 


} 


?> 


输出 : 


test.txt is writeable 


+ 


PHP link() HŽ 


A 


oe : 
link() 函数 建立 一 个 硬 连接 。 
如 果 成 功 ， 则 返回 true， 失 败 则 返回 false. 


提示 : 创建 的 连接 不 是 HTML 链接 ， 而 是 文件 系统 中 的 连接 。 
语法 


link(target,link) 


注释 : ARRATE FAFARA, MBN AB MRF SS UOCE TR DICIT V] e 


注释 : 本 函数 不 能 工作 在 windows 平台 上 。 


PHP linkinfo() HŽ 


定义 和 用 法 
linkinfo() Bok Gz AE A. 


ARM BORGES ID。 若 出 错 ， 则 返回 0 或 FALSE, 


语法 
linkinfo(path) 
参数 
path 必需 。 规 定 要 检查 的 路 径 
提示 和 注释 


注释 : 本 函数 不 能 工作 在 windows 平台 上 。 


PHP Istat() HŽ% 


定义 和 用 法 
Istat() 函数 返回 关于 文件 或 符号 连接 的 信息 。 
语法 

lstat(file) 

file 必需 。 规 定 要 检查 的 文件 。 
说 明 


获取 由 file 参数 指定 的 文件 或 符号 连接 的 统计 信息 。 


Istat() 的 返回 格式 


数字 下 标 关联 键 名 (A PHP 4.0.6) 说 明 

0 dev 设备 名 

1 ino 号 三 

2 mode inode 保护 模式 

3 nlink 被 连接 数目 

4 uid 所 有 者 的 用 户 id 

5 gid 所 有 者 的 组 id 

6 rdev 设备 类 型 ， 如 果 是 inode 设备 的 话 
7 size 文件 大 小 的 字 节 数 

8 atime 上 次 访问 时 间 (Unix a£ ja] Zh) 
9 mtime 上 次 修改 时 间 (Unix 8f i8 X) 
10 ctime 上 次 改变 时 间 (Unix a£ ja] B) 
11 blksize 文件 系统 10 的 块 大 小 


12 blocks 所 占据 块 的 数目 


提示 和 注释 


提示 : RKAS stat) 函数 相同 ， 不 同 之 处 只 有 一 点 : MR file 参数 是 符号 连接 的 话 ， 则 该 符 
号 连接 的 状态 被 返回 ， 而 不 是 该 符号 连接 所 指向 的 文件 的 状态 。 


注释 : 本 函数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 
print_r(lstat("test.txt")); 
?> 

输出 类 似 : 
Array 
( 
[0] => 0 
[1] => 0 
[2] => 33206 
[3] => 1 
[4] => © 
[5] => 0 
[6] => 0 
[7] => 92 


[8] => 1141633430 
[9] => 1141298003 
[10] => 1138609592 


[sal] = edi 
[12] => -1 
[dev] => 0 


[ino] => 0 
[mode] => 33206 
[nlink] => 1 


[uid] => © 
[gid] => © 
[rdev] => 0 


[size] => 92 

[atime] => 1141633430 
[mtime] => 1141298003 
[ctime] => 1138609592 
[blksize] => -1 
[blocks] => -1 

) 


PHP mkdir() 函数 


定义 和 用 法 
mkdir() 2X Æ El K. 


若 成 功 ， 则 返回 true, eSI false. 


语法 


mkdir (path, mode, recursive, context) 





参数 描述 
path 必需 。 规 定 要 创建 的 目录 的 名 称 。 
mode 必需 。 规 定 权 限 。 默 认 是 0777。 
recursive Wi MESH RA, 
context 必需 。 规 定 文件 句柄 的 环境 。Context 是 可 修改 流 的 行为 的 一 套 选 


说 明 
mkdir() 尝试 新 建 一 个 由 path 指定 的 目录 。 


默认 的 mode 是 0777， 意 味 着 最 大 可 能 的 访问 权 。 


提示 和 注释 
注释 : mode 在 Windows 下 被 忽略 。 自 PHP 4.2.0 起 成 为 可 选项 。 


注释 : 对 context 的 支持 是 PHP 5.0.0 添加 的 。 


注释 : recursive 参数 是 PHP 5.0.0 添加 的 。 


例子 


<?php 
mkdir("testing"); 
?> 


PHP move uploaded file() 2 


定义 和 用 法 
move uploaded file() BAU WB a SIFT. 


若 成 功 ， 则 返回 true, BIE false. 
语法 


move uploaded file(file,newloc) 


参数 描述 
file 必需 。 规 定 要 移动 的 文件 。 
newloc 必需 。 规 定 文件 的 新 位 置 。 


说 明 

本 画 数 检 查 并 确保 由 file 指定 的 文件 是 合法 的 上 传 文件 〈 即 通过 PHP 的 HTTP POST 上 传 机 
制 所 上 传 的 ) 。 如 果 文 件 合法 ， 则 将 其 移动 为 由 newloc 指定 的 文件 。 

如 果 file 不 是 合法 的 上 传 文件 ， 不 会 出 现任 何 操作 ，move_uploaded file() 将 返回 false. 


如 果 file 是 合法 的 上 传 文件 ， 但 出 于 某 些 原因 无 法 移动 ， 不 会 出 现任 何 操作 ， 
move uploaded file() 将 返回 false， 此 外 还 会 发 出 一 条 警告 。 


这 种 检查 显得 格外 重要 ， 如 果 上 传 的 文件 有 可 能 会 造成 对 用 户 或 本 系统 的 其 他 用 户 显示 其 内 
容 的 话 。 


提示 和 注释 
注释 : AWA AFB HTTP POST 上 传 的 文件 。 
: 如 果 目 标 文件 已 经 存在 ， 将 会 被 覆盖 。 


PHP parse ini file() 函数 

定义 和 用 法 

parse ini file() 函数 解析 一 个 配置 文件 ， 并 以 数组 的 形式 返回 其 中 的 设置 。 
语法 


parse ini file(file, process sections) 


BR 描述 
file 必需 。 规 定 要 检查 的 ini 文件 。 
, 可 选 。 如 果 设 置 为 true， 则 返回 一 个 多 维 数组 ， 包 括 了 配置 文件 中 
PE ctons 每 一 节 的 名 称 和 设置 。 默 认 是 Td 


说 明 
ini 文件 的 结构 和 php.ini 的 相似 。 


常量 也 可 以 在 ini 文件 中 被 解析 ， 因 此 如 果 在 运行 parse ini file() 之 前 定义 了 常量 作为 ini 的 
值 ， 将 会 被 集成 到 结果 中 去 。 只 有 ini 的 值 会 被 求 值 。 


由 数字 组 成 的 键 名 和 小 节 名 会 被 PHP 当 作 整数 来 人 处理， 因此 以 0 开头 的 数字 会 被 当 作 八进制 
而 以 Ox 开头 的 会 被 当 作 十 六 进 制 。 


提示 和 注释 

注释 : 本 男 数 可 以 用 来 读 取 你 自己 的 应 用 程序 的 配置 文件 。 本 画 数 与 php.ini 文件 没有 关系 ， 
该 文件 在 运行 脚本 时 就 已 经 处 理 过 了 

注释 : 如 果 ini 文件 中 的 值 包含 任何 非 字母 数字 的 字符 ， 需 要 将 其 括 在 双 引 号 中 C. 


注释 : 有 些 保留 字 不 能 作为 ini 文件 中 的 键 名 ， 包 括 : null, yes, no, true 和 false。 值 为 
null, no 和 false 等 效 于 "， 值 为 yes 和 true 等 效 于 "1"。 字 符 "O" 也 不 能 用 在 键 名 的 任 
何 地 方 ， 而 且 这 些 字符 在 选项 值 中 有 着 特殊 的 意义 。 


注释 : A PHP 5.0 版 本 开始 ， 该 范 数 也 义理 选项 值 内 的 新 行 。 


例子 


例子 1 
"test.ini" HAR : 


[names] 
me - Robert 
you - Peter 


[uris] 

first - "http://www.example.com" 

second = "http: //www.w3school.com.cn" 
PHP 代码 : 

«?php 


print r(parse ini file("test.ini")); 
?> 


输出 : 


Array 

( 

[me] -» Robert 

[you] => Peter 

[first] => http://www.example.com 
[second] => http://www.w3school.com.cn 


) 


例子 2 
"test.ini" HARK : 


[names] 
me - Robert 
you - Peter 


[uris] 
first - "http://www.example.com" 
second = "http: //www.w3school.com.cn" 


PHP 代码 (process sections 设置 为 true) 


«?php 
print r(parse ini file("test.ini",true)); 
?> 


输出 : 


Array 
( 


[names] -» Array 


[me] -» Robert 
[you] => Peter 


[urls] => Array 


[first] => http://www.example.com 
[second] => http://www.w3school.com.cn 


) 
) 


PHP pathinfo() HŽ% 
定义 和 用 法 

pathinfo() 函数 以 数组 的 形式 返回 文件 路 径 的 信息 。 
语法 


pathinfo(path, options) 


参数 描述 
path 必需 。 规 定 要 检查 的 路 径 。 
可 选 。 规 定 要 返回 的 数组 元 素 。 默 认 是 all。 可 能 的 值 : 
process sections PATHINFO DIRNAME - 只 返回 dirname PATHINFO BAsENAME - 只 返回 


basename PATHINFO EXTENSION - 只 返回 extension 


3€ BH 
pathinfo() 返回 一 个 关联 数组 包含 有 path 的 信息 。 
包括 以 下 的 数组 元 素 : 


e [dirname] 
e [basename] 
e [extension] 


提示 和 注释 

注释 : 如 果 不 是 要 求 取得 所 有 单元 ， 则 pathinfo() FAIR FÍS FR. 
例子 

例子 1 


<?php 
print r(pathinfo("/testweb/test.txt")); 
?> 


输出 : 


Array 
[dirname] => /testweb 


[basename] -» test.txt 
[extension] -» txt 


) 


例子 2 


<?php 
print r(pathinfo("/testweb/test.txt",PATHINFO BASENAME)); 
?> 


输出 : 


test.txt 


PHP pclose() 函数 


定义 和 用 法 


pclose() PAŽÍ K i5] EH popen() 打开 的 管道 。 


语法 
pclose(pipe) 
参数 描述 
pipe 必需 。 规 定 由 popen() 打开 的 管道 。 


该 图 数 返 回 运行 的 进程 的 终止 状态 


若 出 错 ， 则 返回 false, 


<?php 
$file = popen("/bin/ls","r"); 


// 一 些 要 执行 的 代码 


pclose($file); 
?> 


ŠT 


PHP popen() EZ 


定义 和 用 法 
popen() 函数 打开 进程 文件 指针 。 
语法 


popen(command, mode) 


参数 描述 
command 必需。 规定 要 执行 的 命令 。 


de 必需 。 规 定 连接 模式 。 可 能 的 值 : r: Rik wi: RB (打开 并 清空 已 有 
文件 或 创建 一 个 新 文件 ) 
说 明 
打开 一 个 指向 进程 的 管道 ， 该 进程 由 派生 指定 的 command 命令 执行 而 产生 。 


返回 一 个 和 fopen() 所 返回 的 相同 的 文件 指针 ， 只 不 过 它 是 单 向 的 〈 只 能 用 于 读 或 写 ) FAM 
须 用 pclose() 来 关闭 。 此 指针 可 以 用 于 fgets()，fgetss() 和 fwrite()。 


若 出 错 ， 则 返回 false. 


例子 


<?php 
$file = popen("/bin/ls","r"); 


// 一 些 要 执行 的 代码 


pclose($file); 
?> 


PHP readfile() HŽ% 


定义 和 用 法 
readfile() Eg2X 4$ EH — P 3c fF. 
A ERE A DHEA SU 48 HB CR 


若 成 功 ， 则 返回 从 文件 中 读 和 的 字 节 数 。 若 失败 ， 则 返回 false。 您 可 以 通过 @readfile() 形式 
调用 该 男 数 ， 来 隐藏 错误 信息 。 


语法 


readfile( filename , include path , context ) 


参数 描述 
filename 必需 。 规 定 要 读 取 的 文件 。 
; FETE j s + SEIS E 
include_path 可 选 。 如 果 也 想 在 include path 中 搜索 文件 ， 可 以 使 用 该 参数 并 将 其 设 
为 true。 
context 可 选 。 规 定 文件 句柄 的 环境 。Context 是 可 以 修改 流 的 行为 的 一 套 选 项 。 


说 明 
对 context 参数 的 支持 是 PHP 5.0.0 添加 的 。 
提示 和 注释 


提示 : 如 果 在 php.ini 文件 中 "fopen wrappers" 已 经 被 激活 ， 则 在 本 函数 中 可 以 把 URL 作为 
文件 名 来 使 用 。 


例子 


<?ph 
echo readfile("test.txt"), 
?> 


输出 : 


There are two lines in this file. 
This is the last line. 
57 


PHP readlink() 函数 


定义 和 用 法 
readlink() 范 数 返回 符号 连接 指向 的 目标 。 


AX, WHARF Ee BKK, WR false. 


语法 
readlink(linkpath) 
参数 描述 
linkpath 必需 。 规 定 要 检查 的 连接 路 径 。 


提示 和 注释 


注释 : 本 函数 未 在 Windows 平台 下 实现 。。 


例子 


<?php 
echo readlink("/user/testlink"); 
?> 


PHP realpath() E325 


= ~ N 

realpath() 函数 返回 绝对 路 径 。 

该 图 数 删除 所 有 符号 连接 (比如 Vs Ll ARERI) ， 返 回绝 对 路 径 名 。 
若 失败 ， 则 返回 false。 比 如 说 文件 不 存在 的 话 。 


语法 
readlink(linkpath) 
参数 描述 
linkpath 必需 。 规 定 要 检查 的 连接 路 径 。 
说 明 


在 BSD 系统 上 ， 如 果 仅 仅 是 /inkpath 不 存在 的 话 ，PHP 并 不 会 像 其 它 系 统 那 样 返回 false, 


例子 


<?php 
echo realpath("test.txt"); 
?> 


输出 : 


C:NInetpubNtestwebNtest.txt 


PHP rename() HŽ 


定义 和 用 法 
rename() 函数 重 命名 文件 或 目录 。 


ARH, m KRŽE true。 若 失败 ， 则 返回 false. 


语法 


rename( oldname , newname , context ) 


参数 描述 
oldname 必需 。 规 定 要 重 命名 的 文件 或 目录 。 
rmm 


E 
newname 必需 。 规 定 文件 或 目录 的 新 名 称 。 
定 


context 可 选 。 规 定 文件 句柄 的 环境 。context 是 可 修改 流 的 行为 的 一 套 选项 。 


日 一 Mas 
提示 和 TF 
注释 : TE PHP 4.3.3 Z Bl, rename() 不 能 在 基于 "nix B2 4t FESTIS & 4 DX S dp 4 cts 
注释 : 用 于 oldname 中 的 封装 协议 必须 和 用 于 newname 中 的 相 匹 配 。 


注释 : 对 context 的 支持 是 PHP 5.0.0 添加 的 。 


例子 


<?php 
rename( "images", "pictures"), 
?> 


PHP rewind() E23 


定义 和 用 法 
rewind() 画 数 将 文件 指针 的 位 置 倒 回 文件 的 开头 。 


若 成 功 ， 则 返回 true。 若 失败 ， 则 返回 false. 


语法 
rewind(file) 
参数 
file 必需 。 规 定 已 打开 的 文件 。 


例子 


<?php 
$file = fopen("test.txt","r"); 


// 改 变 文件 指针 的 位 置 
fseek($file,"15"); 


// 把 文件 指针 设 定 为 0 
rewind($file); 


fclose($file); 
?> 


PHP rmdir() 2X 


定义 和 用 法 
rmdir() EA mi PRA El 3 


AKU, 1] Z RAŠURIEJ true。 若 失败 ， 则 返回 false. 


语法 


rmdir(dir,context) 


参数 描述 
dir 必需 。 规 定 要 删除 的 目录 。 
context 必需 。 规 定 文件 句柄 的 环境 。Context 是 可 修改 流 的 行为 的 一 套 选项 。 


说 明 
尝试 删除 dir 所 指定 的 目录 。 该 目录 必须 是 空 的 ， 而 且 要 有 相应 的 权限 。 
提示 和 注释 


注释 : 对 context 的 支持 是 PHP 5.0.0 添加 的 。 


例子 


<?php 
$path = "images", 
if(!rmdir($path)) 

echo ("Could not remove $path"); 


?> 


PHP set file buffer() 函数 


定义 和 用 法 
set file buffer() 函数 设置 打开 文件 的 缓冲 大 小 。 


知 成 功 ， 则 该 函数 返回 0。 若 失败 ， 则 返回 EOF. 
ja 


set file buffer(file,buffer) 


参数 描述 
file 必需 。 规 定 打 开 的 文件 。 
buffer 必需 。 规 定 缓冲 大 小 ， 以 字 节 计 。 


提示 和 注释 


注释 : AWA stream set write buffer() 的 别名 。 


例子 
创建 无 组 冲 的 流 : 


<?php 
$file = fopen("test.txt","w"); 
if ($file) 


{ 

set_file_buffer($file,0); 
fwrite($file, "Hello World. Testing!"); 
fclose($file); 

J 


2» 


+ 


PHP stat() 2X 


A 


rm 、 i 
stat() Pq245/x [p] X FXE A. 
语法 
fstat(file) 
参数 描述 
file 必需 。 规 定 要 检查 的 文件 。 
说 明 


获取 由 file 指定 的 文件 的 统计 信息 。 如 果 file 是 符号 连接 ， 则 统计 信息 是 关于 被 连接 文件 本 身 
的 ， 而 不 是 符号 连接 。 


如 果 出 错 ，stat() 返回 false， 并 且 发 出 一 条 警告 。 


返回 的 数组 包含 有 文件 的 统计 信息 ， 该 数组 具有 以 下 列 出 的 单元 ， 数 组 下 标 从 震 开 始 。 除 了 
数字 索引 之 外 ， 从 PHP 4.0.6 起 还 可 以 通过 关联 索引 来 访问 。 


stat() 的 返回 格式 


数字 下 标 关联 键 名 〈 自 PHP 4.0.6) 说 明 

0 dev 设备 名 

1 ino 号 三 

2 mode inode 保护 模式 

3 nlink 被 连接 数目 

4 uid 所 有 者 的 用 户 id 

5 gid 所 有 者 的 组 id 

6 rdev 设备 类 型 ， 如 果 是 inode 设备 的 话 

7 size 文件 大 小 的 字 节 数 

8 atime 上 次 访问 时 间 (Unix mr jg 8) 

9 mtime 上 次 修改 时 间 (Unix m ig] 8x) 

10 ctime 上 次 改变 时 间 (Unix at i] Be) 

11 blksize 文件 系统 IO 的 块 大 小 

12 blocks 所 占据 块 的 数目 
提示 和 注释 


提示 : Istat() 与 stat() 类 似 ， 不 同 的 是 ， 它 会 返回 符号 连接 的 状态 。 


注释 : 本 求 数 的 结果 会 被 缓存 。 请 使 用 clearstatcache() 来 清除 缓存 。 


例子 


<?php 

$file = fopen("test.txt","r"); 
print_r(stat($file)); 
fclose($file); 

?> 


输出 类 似 : 


Array 
( 


[0] => 0 
[1] => 9 
[2] => 33206 
[3] => 1 
[4] => 0 
[5] => 0 
[6] => 0 
[7] => 92 


[8] => 1141633430 
[9] => 1141298003 
[10] => 1138609592 


[11] => -1 
Hei = mí 
[dev] => 0 


[ino] => 0 
[mode] => 33206 
[nlink] => 1 


[uid] => 0 
[gid] => 0 
[rdev] => 0 


[size] => 92 

[atime] => 1141633430 
[mtime] => 1141298003 
[ctime] => 1138609592 
[blksize] => -1 
[blocks] => -1 

) 


PHP symlink() E32X 
定义 和 用 法 

symlink() 函数 创建 符号 连接 。 

语法 


link(target,link) 


target Wy 


link v 


说 明 


symlink() 对 于 已 有 的 target 建立 一 个 名 为 link 的 符号 连接 。 


若 成 功 则 返回 true， 失 败 则 返回 false. 


提示 和 注释 


注释 : AWAKE Windows 平台 下 实现 。 


PHP tempnam() 函数 


定义 和 用 法 
tempnam() 画 数 创 建 一 个 具有 唯一 文件 名 的 临时 文件 。 
若 成 功 ， 则 该 函数 返回 新 的 临时 文件 名 。 若 失败 ， 则 返回 false, 


参数 描述 
dir 必需 。 规 定 创 建 临 时 文件 的 目录 。 
prefix 必需 。 规 定 文件 名 的 开头 。 


说 明 
在 指定 目录 中 建立 一 个 具有 唯一 文件 名 的 文件 。 如 果 该 目录 不 存在 ，tempnam() 会 在 系统 临 
时 目录 中 生成 一 个 文件 ， 并 返回 其 文件 名 。 


在 PHP 4.0.6 之 前 ，tempnam() 函数 的 行为 取决 于 系统 。 在 Windows F TMP 环境 变量 会 越 
过 dir 参数 ， 在 Linux 下 TMPDIR 环境 变量 优先 ， 而 在 SVR4 下 总 是 使 用 dir 参数 ， 如 果 其 指 
向 的 目录 存在 的 话 。 


提示 和 注释 


注释 : 如 果 PHP 不 能 在 指定 的 dir 参数 中 创建 文件 ， 则 退回 到 系统 默认 值 。 


注释 : 本 图 数 的 行为 在 4.0.3 版 中 改变 了 。 也 会 建立 一 个 临时 文件 以 避免 竟 争 情形 ， 即 有 可 能 
会 在 产生 出 作为 文件 名 的 字符 串 与 脚本 真正 建立 该 文件 之 间 会 在 文件 系统 中 存在 同名 文件 。 
注意 ， 如 果 不 再 需要 该 文件 则 要 删除 此 文件 ， 不 会 自动 删除 的 。 


提示 : 参见 tmpfile() 


例子 


<?php 
echo tempnam("C:NinetpubNtestweb", "TMPO"); 
?> 


输出 : 


C:NinetpubNtestwebNTMP1. tmp 


PHP tmpfile() 2X 


定义 和 用 法 
tmpfile() HALES (w+) 模式 建立 一 个 具有 唯一 文件 名 的 临时 文件 。 
文件 会 在 关闭 后 (用 fclose()) 自动 被 删除 ， 或 当 脚本 结束 后 。 


1) 


tmpfile() 


提示 和 注释 


提示 : 参见 tempnam(). 


例子 


<?php 
$temp = tmpfile(), 


fwrite($temp, "Testing, testing."); 


// 倒 回 文 件 的 开头 


rewind($temp); 


// 从 文件 中 读 取 1k 
echo fread($temp, 1024), 


// 删 除 文件 


fclose($temp); 
?> 


Testing, testing. 


PHP touch() 函数 
定义 和 用 法 

touch() 画 数 设置 指定 文件 的 访问 和 修改 时 间 。 
语法 


touch(filename, time,atime) 


参数 描述 
filename 必需 。 规 定 要 接触 的 文件 。 
time 可 选 。 设 置 时 间 。 默 认 是 当前 系统 时 间 。 
atime 可 选 。 设 置 访问 时 间 。 上 默认 是 当前 系统 时 间 。 


说 明 
尝试 将 由 filename 给 出 的 文件 的 访问 和 修改 时 间 设 定 为 指定 的 时 间 。 如 果 没 有 设置 可 选 参数 


time， 则 使 用 当前 系统 时 间 。 如 果 给 出 了 第 三 个 参数 atime， 则 指定 文件 的 访问 时 间 会 被 设 为 
atime 。 


如 果 成 功 则 返回 true， 失 败 则 返回 false. 
提示 和 注释 
注释 : 如 果 文 件 不 存在 ， 则 会 被 创建 。 


例子 


<?php 
touch("test.txt"); 
?> 


PHP umask() 函数 


定义 和 用 法 
umask() 函数 改变 当前 的 umask. 


umask() 将 PHP 的 umask 设 定 为 mask & 0777 并 返回 原来 的 umask。 当 PHP 被 作为 服务 
器 模块 使 用 时 ， 在 每 个 请 求 结束 后 umask 会 被 恢复 。 


无 参数 调用 umask() 会 返回 当前 的 umask。 


语法 
umask(mask) 
参数 描述 
mask 必需 。 规 定 新 的 权限 。 上 默认 是 0777。 
日 二 2—- + 
提示 和 注释 


注释 : 在 多 线程 的 服务 器 上 尽量 避免 使 用 这 个 画 数 。 创 建文 件 后 要 改变 其 权限 最 好 还 是 使 用 
chmod()。 使 用 umask() 会 导致 并 发 程序 和 服务 器 发 生 不 可 预知 的 情况 ， 因 为 它们 使 用 相同 的 
umask. 


PHP unlink() 函数 


定义 和 用 法 
unlink() EIZ ql BRITE. 


若 成 功 ， 则 返回 true， 失 败 则 返回 false. 


语法 


unlink(filename, context) 


参数 描述 
filename 必需 。 规 定 要 删除 的 文件 。 
context 可 选 。 规 定 文件 句柄 的 环境 。Context 是 可 修改 流 的 行为 的 一 套 选 项 。 


提示 和 注释 


注释 : 对 context 的 支持 是 PHP 5.0.0 添加 的 。 


例子 


<?php 
$file — kest EXEN 
if (!unlink($file)) 


echo ("Error deleting $file"); 
else 

{ 

echo ("Deleted $file"); 

} 


?> 


PHP Filter EZ 


PHP Filter 简介 
PHP 过 滤器 用 于 对 来 自 非 安全 来 源 的 数据 (比如 用 户 输入 ) 进行 验证 和 过 


ria J+ 


RR 


filter HA PHP DARD. FH ASR BN n] fs FH ix eR, 


PHP Filter 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


函数 描述 
filter has var() 检查 是 否 存 在 指定 输入 类 型 的 变量 。 
filter id() 返回 指定 过 滤器 的 ID 号 。 
filter input() 从 脚本 外 部 获取 输入 ， 并 进行 过 滤 。 
filter input array() 从 脚本 外 部 获取 多 项 输入 ， 并 进行 过 滤 。 
filter list() 返回 包含 所 有 得 到 支持 的 过 滤器 的 一 个 数组 。 
filter var array() 获取 多 项 变量 ， 并 进行 过 滤 。 
filter var() 获取 一 个 变量 ， 并 进行 过 滤 。 


PHP Filters 


ID 名 称 描述 
调用 用 户 自 定义 函数 来 过 
FILTER CALLBACK 滤 数据 。 
FILTER SANITIZE STRING 去 除 标签 ， 去 除 或 编码 特 
E = 殊 字 符 。 
FILTER SANITIZE STRIPPED "string" i 过 滤器 的 别名 。 
URL-encode 字符 串 ， 去 
FILTER_SANITIZE_ENCODED 除 或 编码 特殊 字符 。 


HTML 转 义 字符 "<>& 以 


PHP 


a; a!) a; N | 0] | CO | O1 


W3School PHP 参考 手册 


FILTER SANITIZE SPECIAL CHARS 


FILTER SANITIZE EMAIL 


FILTER SANITIZE URL 


FILTER SANITIZE NUMBER INT 


FILTER SANITIZE NUMBER FLOAT 
FILTER SANITIZE MAGIC GUOTES 


FILTER UNSAFE RAW 


FILTER VALIDATE INT 


FILTER VALIDATE BOOLEAN 


FILTER VALIDATE FLOAT 
FILTER VALIDATE REGEXP 
FILTER VALIDATE URL 


FILTER VALIDATE EMAIL 


FILTER VALIDATE IP 


PHP Filter Eu 


X ASCII 值 小 于 32 的 字 


‘Jo 


删除 所 有 字符 ， 除 了 字 
母 、 数 字 以 及 !(#$%&"*+- 
[22^ X 


ORE, TT n 
À 数字 以 及 $- „+, [| <>#%";/?:@&= 


删除 所 有 字符 ， 除 了 数字 
和 +- 


删除 所 有 字符 ， 除 了 数 
字 、 +- 以 及 „EE. 


应 用 addslashes(). 


不 进行 任何 过 滤 ， 去 除 或 
编码 特殊 字符 。 


在 指定 的 范围 以 整数 验证 
值 。 

如 果 是 "1", "true", "on" 
以 及 "yes"， 则 返回 

true， 如 果 是 "0", "false", 
"off", "no" UR, maz 
[7] false, £ nA El 
NULL, 


以 浮 点 数 验 证 值 。 


根据 regexp， 兼 容 Perl 
的 正则 表达 式 来 验证 值 。 


把 值 作为 URL 来 验证 。 


把 值 作为 e-mail 来 验 
证 。 


把 值 作为 IP 地 址 来 验 
证 。 


rel 


412 


PHP filter has var() Ea 


Sm > S 
filter has var() BAK & S & tz TEIEGE 4A FU TE, 
若 成 功 ， 则 返回 true, EURE false. 
语法 
filter has var(type, variable) 


参数 描述 


必需 。 规 定 要 检查 的 类 型 。 可 能 的 值 : INPUT_GET INPUT POST 
INPUT COOKIE INPUT SERVER INPUT ENV 


variable ”必需 。 规 定 要 检查 的 变量 。 


type 


例子 
在 本 例 中 ， 输 入 变量 "name" 被 发 送 到 PHP 页 面 : 


<?php 
if(!filter has var(INPUT GET, "name")) 
echo("Input type does not exist"); 
else 

echo("Input type exists"); 


?> 


输出 类 似 : 


Input type exists 


PHP filter id() 函数 


定义 和 用 法 

filter id() 本 数 返回 指定 过 滤器 的 ID 号 。 

若 成 功 ， 则 返回 过 滤器 的 ID 号 。 如 果 该 过 滤器 不 存在 ， 则 返回 NULL。 
语法 


filter id(filter name) 


A 
$ 述 
T 描述 


t pe 必需 。 规定 被 获 k HX ID 号 的 过 滤器 。 必 须 是 过 滤器 名 称 (不 是 过 二 滤器 ID 名 ) o 请 
y 使 用 filter list() 函数 来 获取 所 有 被 支持 的 过 滤器 的 名 称 。 


例子 


<?php 
echo(filter id("validate email")), 
?> 


输出 类 似 : 


274 


PHP filter input() EX2K 


定义 和 用 法 


filter input() EK 


FA AB aR Hg A, HATE. 


本 函数 用 于 对 来 自 非 安全 来 源 的 变量 进行 验证 ， 上 比如 用 户 的 输入 


APE BLA METAR K BUR A : 


e INPUT GET 

e INPUT POST 

e INPUT COOKIE 

e INPUT ENV 

e INPUT SERVER 

e INPUT SESSION (Not vet implemented) 
e INPUT REGUEST (Not vet implemented) 


如 果 成 功 ， 则 3 
回 NULL。 


语法 


返回 被 过 滤 的 数据 ， 如 果 失 败 ， 则 返回 false, WR variable 参数 未 设置 ， 则 返 


filter_input(input_type, variable, filter, options) 


参数 
input_type 


variable 
filter 


options 


例子 


描述 
TO o 规定 输入 类 i, SB Z x 见 上 面 的 列表 中 可 能 类 型。 


可 选 。 规定 要 使 用 的 过 滤器 的 ID。 默认 是 FILTER SANITIZE STRING, 
请 参见 完整 的 PHP Filter 函数 参考 手册 ， 获 得 可 能 的 过 滤器 。 过 滤器 ID 可 
以 是 ID 名 称 (比如 FILTER_VALIDATE_EMAIL) ， 或 ID 号 (比如 
274) 。 


规定 包含 标志 / 选 的 数组 。 检查 每 个 ; 过 滤器 可 和 有 6 的 标志 和 选 项 。 


在 本 例 中 ， 我 们 使 用 filter_input() 函数 来 过 滤 一 个 POST 变量 。 所 接受 的 POST 变量 是 合法 


的 e-mail 地 址 。 


<?php 
if (!filter input(INPUT POST, "email", FILTER VALIDATE EMAIL)) 


echo "E-Mail is not valid", 
J 
else 

echo "E-Mail is valid", 


j 


?> 


输出 类 似 : 


E-Mail is valid 


PHP filter input array() 2 


mo. N 
filter input array() 函数 从 脚本 外 部 获取 多 项 输入 ， 并 进行 过 滤 。 
本 本 数 无 需 重复 调用 filter_input()， 对 过 滤 多 个 输入 变量 很 有 用 。 
本 画 数 可 从 各 种 来 源 获 取 输 入 : 


e INPUT GET 

e INPUT POST 

e INPUT COOKIE 

e INPUT ENV 

e INPUT SERVER 

e INPUT SESSION (Not vet implemented) 
e INPUT REGUEST (Not vet implemented) 


如 果 成 功 ， 则 返回 被 过 滤 的 数据 ， 如 果 失 败 ， 则 返回 false, 
语法 
filter input(input type, args) 
参数 描述 


input type ”必需 。 规 定 输 入 类 型 。 参 见 上 面 的 列表 中 可 能 的 类 型 。 


可 选 。 规 定 过 滤器 参数 数组 。 合 法 的 数组 键 是 变量 名 。 合 法 的 值 是 过 滤器 
args ID， 或 者 规定 过 滤器 、 标 志 以 及 选项 的 数组 。 该 参数 也 可 以 是 一 个 单独 的 
过 滤器 ID， 如 果 是 这 样 ， 输 入 数组 中 的 所 有 值 由 指定 过 滤器 进行 过 滤 。 


a — gn? g 
提示 和 LESE 
提示 : 参见 完整 的 PHP Filter SSFM, SASAKA [B8 BJ S ea. 


例子 


在 本 例 中 ， 我 们 使 用 filter_input_array() HAKit 7€ Z POST FB. AHSAN POST 变量 
是 姓名 、 年 龄 以 及 电子 邮件 地 址 : 


<?php 
$filters - array 


( 


"name" -» array 


"filter"->FILTER CALLBACK, 
"flags"->FILTER FORCE ARRAY, 
"options"->"ucwords" 


r 


"age" -» array 


"filter"->FILTER VALIDATE INT, 
"options"=>array 
( 
"min_range"=>1, 
"max_range"=>120 
) 
), 
"email"-» FILTER VALIDATE EMAIL, 
) ; 
print r(filter input array(INPUT POST, $filters)); 
?> 


输出 类 似 : 
Array 
( 
[name] -» Peter 
[age] => 41 


[email] -» peterQexample.com 


) 


PHP filter list() HŽ 


定义 和 用 法 
filter list() 函数 返回 包含 所 有 得 到 支持 的 过 滤器 的 一 个 数组 。 
语法 


filter list() 


提示 和 注释 


注释 : 该 贺 数 的 结果 不 是 过 滤器 的 ID， 而 是 过 滤器 名 称 。 请 使 用 filter_id() 画 数 来 获取 过 滤器 
ID. 


例子 


<?php 
print r(filter list()); 
?> 


输出 类 似 : 


[0] => int 

[1] => boolean 

[2] => float 

[3] —> validate regexp 
[4] => validate url 
[5] —> validate email 
[6] => validate ip 
[7] => string 

[8] => stripped 

[9] => encoded 

[10] => special_chars 
[11] => unsafe_raw 
[12] => email 

[13] => url 

[14] => number int 
[15] -» number float 
[16] -» magic quotes 
[17] => callback 


PHP filter var array() HŽ% 


= 、 N 
filter var array() HRRMS RES, FATHIE, 
由 于 无 需 重复 调用 filter_input()， 因 此 本 函数 对 过 滤 多 个 变量 很 有 用 。 
如 果 成 功 ， 则 返回 包含 被 过 滤 的 变量 值 的 数组 ， 如 果 失 败 ， 则 返回 false. 
语法 

filter_var_array(array, args) 

参数 描述 


aray ”必需 。 规 定 带 有 字符 串 键 的 数组 ， 包 含 要 过 滤 的 数据 。 


可 选 。 规 定 过 滤器 参数 数组 。 合 法 的 数组 键 是 变量 名 。 合 法 的 值 是 过 滤器 ID, 
args 或 者 规定 过 滤器 、 标志 以 及 选项 的 数组 。 该 参数 也 可 以 是 一 个 单独 的 过 滤器 
ID， 如 果 是 这 样 ， 输 入 数组 中 的 所 有 值 由 指定 过 滤器 进行 过 滤 。 


提示 和 注释 


提示 : 参见 完整 的 PHP Filter 参考 手册 ， 坦 看 可 与 该 画 数 一 同 使 用 的 过 滤器 。 


例子 


<?php 
$arr - array 
( 
"name" => "peter griffin", 
"age" => M pu. 
"email" -» "peterQexample.com", 


); 


$filters = array 


( 


"name" -» array 


"filter"->FILTER CALLBACK, 
"flags"->FILTER FORCE ARRAY, 
"options"->"ucwords" 

), 
"age" -» array 

( 

"filter"->FILTER VALIDATE INT, 
"options"->array 

( 

"min range"-»1, 

"max range"->120 

) 

) 
"email"-» FILTER VALIDATE EMAIL, 
); 


print_r(filter_var_array($arr, $filters)); 
?> 


输出 类 似 : 
Array 
( 
[name] -» Peter Griffin 
[age] => 41 


[email] -» peterQexample.com 


) 


PHP filter var() 函数 


定义 和 用 法 
filter var() 本 数 通过 指定 的 过 滤器 过 滤 变量 。 
如 果 成 功 ， 则 返回 已 过 滤 的 数据 ， 如 果 失 败 ， 则 返回 false, 


语法 


filter var(variable, filter, options) 


参数 描述 
variable 必需 。 规 定 要 过 滤 的 变量 。 
filter 可 选 。 规 定 要 使 用 的 过 滤器 的 ID. 
options 规定 包含 标志 /选项 的 数组 。 检 查 每 个 过 滤器 可 能 的 标志 和 选项 。 


提示 和 注释 


提示 : 参见 完整 的 PHP Filter 参考 手册 ， 查 看 可 与 该 落 数 一 同 使 用 的 过 滤器 。 


例子 


<?php 
if(!filter var("someoneQexample....com", FILTER VALIDATE EMAIL)) 


echo("E-mail is not valid"); 
J 
else 

echo( "E-mail is valid"); 


j 


?> 


输出 类 似 : 


E-mail is not valid 


PHP FTP 函数 


PHP FTP 简介 


FTP 函数 通过 文件 传输 协议 (FTP) 提供 对 文件 服务 器 的 客户 端 访问 。 


FTP 函数 用 于 打开 、 登 录 以 及 关闭 连接 ， 同时 用 于 上 传 、 下 载 、 重 名 命 、 删 除 及 获取 文件 服 
务 器 上 的 文件 信息 。 不 是 所 有 FTP 画 数 对 每 个 服务 器 都 起 作用 或 返回 相同 的 站 果 。 自 PHP 3 
起 ，FTP 函数 可 用 。 


这 些 画 数 用 于 对 FTP 服务 器 进行 细致 的 访问 。 如 果 您 仅仅 需要 对 FTP 服务 器 进行 读 写 操作 ， 

建议 使 用 Filesystem EX2 ÉS ftp:// wrapper. 

œ J+ 

安装 

PHP 的 Windows 版 本 已 经 内 置 该 FTP 扩展 模块 的 支持 。 无 需 加 载 任 何 附 加 扩展 库 即 可 使 用 
xe, 


不 过 ， 如 果 您 运行 的 是 PHP 的 Linux 版 本 ， 在 编译 的 时 候 请 添加 --enable-ftp 选项 (PHP4 或 
以 上 版 本 ) 或 者 --with-ftp (PHP3 版 本 )。 


PHP FTP EZ 
PHP : JRzRSE REALES E PHP 版 本 。 

ERA 描述 PHP 
ftp_alloc() 为 要 上 传 到 FTP 服务 器 的 文件 分 配 空间 。 5 
ftp cdup() 把 当前 目录 改变 为 FTP 服务 器 上 的 父 目 录 。 3 
ftp_chdir() 改变 FTP 服务 器 上 的 当前 目录 。 3 
ftp chmod() 通过 FTP 设置 文件 上 的 权限 。 5 
ftp close() 关闭 FTP 连接 。 4 
ftp connect() 打开 FTP 连接 。 3 
ftp_delete() 删除 FTP 服务 器 上 的 文件 。 3 
ftp exec() TE FTP 上 执行 一 个 程序 /命令 。 4 


从 FTP 服务 器 上 下 载 一 个 文件 并 保存 到 本 地 一 个 已 经 打开 
ftp_fget() 的 文件 中 。 3 


ftp fput() 


ftp get option() 


fip get() 

ftp login() 
ftp mdtm() 
ftp mkdir() 


ftp nb continue() 


ftp nb fget() 


ftp nb fput() 


ftp nb get() 


ftp nb put() 


ftp nlist() 
ftp pasv() 
ftp put() 

ftp pwd() 
ftp. quit() 
ftp raw() 


ftp rawlist() 


ftp rename() 


ftp rmdir() 


ftp set option() 


ftp site() 
ftp size() 


ftp ssl connect() 


ftp systype() 


PHP FT 


PHP : 指示 支 


P 
持 


ni 
rt 
RS 


iA 


上 传 一 个 已 打开 的 文件 ， 并 在 FTP 服务 器 上 把 它 保 存 为 一 
ARE s 


返回 当前 FTP 连接 的 各 种 不 同 的 选项 设置 。 
从 FTP 服务 器 下 载 文件 。 

登录 FTP 服务 器 。 

返回 指定 文件 的 最 后 修改 时 间 。 

在 FTP 服务 器 创建 一 个 新 目录 。 
连续 获取 一 发送 文件 (non-blocking)。 


从 FTP 服 务 器 上 下 载 文件 并 保存 到 本 地 已 经 打开 的 文件 中 
(non-blocking) 


上 传 已 打开 的 文件 ， 并 在 FTP 服 务 器 上 把 它 保存 为 文件 
(non-blocking)。 


从 FTP 服务 器 下 载 文件 (non-blocking)。 
把 文件 上 传 到 服务 器 (non-blocking)。 
返回 指定 目录 的 文件 列表 。 

返回 当前 FTP 被 动 模式 是 否 打开 。 

把 文件 上 传 到 服务 器 。 

返回 当前 目录 名 称 。 

ftp_close() 的 别名 。 

向 FTP 服务 器 发 送 一 个 raw fp. 
返回 指定 目录 中 文件 的 详细 列表 。 

重 命名 FTP 服务 器 上 的 文件 或 目录 。 
删除 FTP 服务 器 上 的 目录 。 

设置 各 种 FTP 运行 时 选项 。 

向 服务 器 发 送 SITE RR. 
返回 指定 文件 的 大 小 。 

打开 一 个 安全 的 SSL-FTP 连接 。 

返回 远程 FTP 服务 器 的 系统 类 型 标识 符 。 


Ex 
时 


量 的 最 早 的 PHP 版 本 。 


a wow U mL 


C A U U A U CQ CQ Ci CQ U U U wo A A 


常量 描述 
FTP ASCII 
FTP TEXT 
FTP BINARY 
FTP IMAGE 
FTP TIMEOUT SEC 
FTP AUTOSEEK 


为 GET 和 PUT 请 求 自动 决定 恢复 和 开始 的 位 置 只 能 


FTP_AUTORESUME | Tusc FTP AUTOSEEK 条 天 的 情况 下 


FTP FAILED 异步 传输 失败 
FTP_FINISHED 异步 传输 成 功 


ER 
FTP MOREDATA 异步 传输 是 活动 状态 的 


PHP ftp alloc() Hz 


定义 和 用 法 
ftp alloc() EA 4 BE E 4:8 FTP 服务 器 的 文件 分 配 空 间 。 


若 成 功 ， 则 返回 true。 否 则 返回 false. 


语法 


ftp alloc(ftp connection, size, return) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 。 


定 
size 可 选 。 规 定 要 分 配 的 字 节 数 。 
定 


return 可 选 。 规 定 存储 服务 器 响应 的 字 节 数 。 


提示 和 注释 


注释 : 很 多 服务 器 不 支持 该 命令 。 


例子 
例子 1 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp alloc($conn, "160", $response), 
echo $response, 


ftp close($conn); 
?> 


例子 2 


<?php 
$file - "myfile.txt"; 


$conn - ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


if (ftp alloc($conn, filesize($file), $response)) 
echo "Space allocated on server."; 
J 


else 


echo "Unable to allocate space. " . $response, 


J 
ftp close($conn); 


?> 


PHP ftp cdup() Hak 


mo 、 N 
ftp cdup() 函数 把 当前 目录 改变 为 FTP 服务 器 上 的 父 目 录 。 


若 成 功 ， 则 返回 true. AIRE) false. 
语法 


ftp cdup(ftp connection) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


// 输 出 当前 目录 
echo "Dir: ".ftp pwd($conn), 
echo "«br /»"; 


// 更 改 为 images 目录 

ftp chdir($conn, images"); 
echo "Dir: ".ftp pwd($conn); 
echo "<br />"; 





// 把 当前 目录 切换 为 父 目 录 
ftp cdup($conn), 
echo "Dir: ".ftp pwd($conn), 


ftp close($ftp server); 
?> 


输出 : 


Dir: / 
Dir: /images 
Dir: / 


PHP ftp chdir() 函数 


定义 和 用 法 


ftp_chdir() 函数 改变 FTP 服务 器 上 的 当前 目录 。 


若 成 功 ， 则 返回 true, ARE false。 如 果 切 换 目 录 失 败 ，PHP 还 会 发 出 一 


语法 


ftp_chdir(ftp_connection,directory) 


参数 描述 


ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


directory 必需 。 规 定 要 切换 到 的 目录 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


// 输 出 当前 目录 

echo "Dir: ".ftp pwd($conn), 
echo "«br /»"; 

// 切 换 为 images 目录 

ftp chdir($conn, images"); 
echo "Dir: ".ftp pwd($conn), 


ftp close($ftp server); 
?> 


俞 出 : 


Dir: / 
Dir: /images 


PHP ftp chmod() 函数 


定义 和 用 法 
ftp chmod() 函数 设置 FTP 服务 器 上 指定 文件 的 权限 。 


若 成 功 ， 则 该 范 数 返回 新 的 权限 。 否 则 返回 false。 
语法 


ftp chmod(ftp connection,mode,file) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
mode 必需 。 规 定 新 的 权限 。 
file 必需 。 规 定 要 修改 权限 的 文件 的 名 称 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp_login($conn, "user","pass"); 


// 所 有 者 可 读 写 ， 其 他 人 没有 任何 权限 
ftp chmod($conn, "0600", "test.txt"), 


// 所 有 者 可 读 写 ， 其 他 人 可 读 
ftp chmod($conn, "0644", "test.txt"), 


// 所 有 者 拥有 所 有 权限 ， 其 他 人 可 读 可 执行 
ftp chmod($conn, "0755", "test.txt"), 








// 所 有 者 拥有 所 有 权限 ， 所 有 者 所 属 的 组 可 读 
ftp chmod($conn, "0740", "test.txt"), 


ftp close($conn); 
?> 


PHP ftp close() 函数 


定义 和 用 法 
ftp close() HAX p] FTP 连接 。 


OK [0 SHANE nin IA UR 
语法 


ftp close(ftp connection) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 


// 要 执行 的 一 些 代 码 


ftp close($conn), 
?> 


PHP ftp connect() 2 


= 、 S 
ftp connect() 函数 建立 一 个 新 的 FTP 连接 。 

若 成 功 ， 则 返回 一 个 连接 标识 ， 否 则 返回 false. 
语法 


ftp connect(host, port, timeout ) 


参数 描述 


必需 。 规 定 要 连接 的 FTP 服务 器 。 可 以 是 域名 或 IP 地 址 。 后 面 不 应 以 斜 线 结 
前 面 也 不 需要 用 ftp: // 开头 。 


port 可 选 。 规 定 FTP 服务 器 的 端口 。 
timeout ， 可 选 。 规 定 该 FTP 服务 器 的 超时 时 间 。 默 认 是 90 秒 。 


host 


MI 


说 明 
提示 : 超时 时 间 可 以 在 任何 时 候 通 过 函数 ftp set option() 及 ftp_get_option() 来 改变 和 获 
取 。 


参数 timeout 仅 适 用 于 PHP 4.2.0 及 以 上 版 本 。 


例子 


本 例 尝试 连接 一 个 FTP 服务 器 。 如 果 连 接 失 败 ， 则 die) 函数 将 终止 脚本 ， 并 输出 一 条 消 
息 : 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
?> 


PHP ftp delete() 西数 


定义 和 用 法 


ftp delete() Až m]E& FTP 服务 器 上 的 一 个 文件 。 


若 成 功 ， 则 返回 true, BRE false. 


1) 


ftp delete(ftp connection, path) 


参数 
ftp connection 必需 
path 必需 


说 明 


o A 
sa 


要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


定 
定 要 删除 的 文件 的 路 径 。 


ftpdelete() HAK mil FTP ARS AR TEJTO path 指定 的 的 文件 。 


例子 


<?php 


$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


echo ftp delete($conn, "test.txt"), 


ftp close($conn), 
?> 


输出 : 


PHP ftp exec() 函数 


E3 i 
ftp exec() 函数 请 求 在 FTP 服务 器 上 执行 一 个 程序 或 命令 。 
若 成 功 (服务 器 发 送 关 响 应 代码 200) , TJ 3 返回 true, 否则 返回 false. 


语法 


ftp exec(ftp connection, command) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
command 必需 。 规 定 发 送 到 服务 器 的 命名 请 求 。 


该 图 数 发 送 一 个 SITE EXEC command 请 求 到 FTP 服务 器 。 


提示 和 注释 


与 ftp raw() 2% 不 同 ，ftp_exec() 只 有 在 登录 到 FTP 服务 器 后 才能 发 送 命 命 。 


例子 


<?php 

$command = "ls-al > test.txt"; 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


if (ftp exec($conn, $command) ) 
echo "Command executed successfully"; 
J 


else 


echo "Execution of command failed"; 


J 


ftp close($conn), 
?> 


PHP ftp fget() 2X 


定义 和 用 法 


ftp fget() KAM FTP 服务 器 上 下 载 一 个 文件 并 保存 到 本 地 一 个 已 经 打开 的 文件 中 。 
若 成 功 则 返回 true， 失 败 则 返回 false. 


语法 


ftp fget(ftp connection, local, remote, mode, resume) 


BR 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) o 
local 必需 。 本 地 已 经 打开 的 文件 的 句柄 。 
remote 必需 。 规 定 从 中 进行 拷贝 的 文件 的 路 径 。 
mode 必需 。 规 定 传 输 模式 。 可 能 的 值 有 月 : FTP_ASCII FTP_BINARY 
resume 必需 。 规 定 在 远程 文件 中 的 何 处 开始 拷贝 。 上 默认 是 0。 


说 明 
参数 resume 仅 适用 于 PHP 4.3.0 以 上 版 本 


例子 


本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 


<?php 
$source = "source.txt"; 
$target - fopen("target.txt", "w"); 


$conn - ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp fget($conn, $target, $source, FTP ASCII); 


ftp close($conn); 
?> 


PHP ftp fput() 函数 


rm . N 
ftp fput() 范 数 上 传 一 个 已 经 打开 的 文件 到 FTP 服务 器 。 
若 成 功 则 返回 true， 失 败 则 返回 false。 


语法 


ftp fput(ftp connection, remote, local, mode, resume) 


BR 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
remote 必需 。 上 传 到 服务 器 上 的 文件 名 。 
local 必需 。 规 定 所 打开 文件 的 句柄 。 
mode 必需 。 规 定 传 输 模式 。 可 能 的 值 有 月 : FTP_ASCII  FTP BINARY 
resume 必需 。 规 定 在 本 地 文件 中 的 何 处 开始 拷贝 。 上 默认 是 0。 


说 明 


参数 resume 仅 适用 于 PHP 4.3.0 以 上 版 本 


例子 


本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 
<?php 
$source = fopen("source.txt","r"); 


$conn - ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


echo ftp fput($conn, "target.txt", $source, FTP ASCII); 


ftp close($conn), 
?> 


输出 : 


W3School PHP 参考 手册 


PHP ftp fput() Egit 437 


Ne 


PHP ftp get option() 函数 
定义 和 用 法 
ftp get option() 郴 数 返回 当前 FTP 连接 的 各 种 不 同 的 选项 设置 。 
语法 

ftp get option(ftp connection,option) 


参数 描述 
ftp connection ”必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
必需 。 规 定 要 返回 的 选项 。 可 能 的 值 有 : FTP TIMEOUT SEC - 返回 网 络 


option 操作 的 时 间 限 制 FTP AUTOSEEK - 如 果 设 置 该 选项 ， 则 返回 true, Ar 
返回 false 


说 明 
如 果 成 功 ， 则 返回 选项 的 值 ， 否 则 ， 如 果 给 定 的 参数 option 选项 若 不 被 支持 ， 则 返回 false 
同时 会 提示 一 条 错误 信息 。 


此 函数 会 返回 连接 句柄 为 ftp_connection， 指 定 键 值 option 的 值 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp get option($conn, FTP TIMEOUT SEC), 


ftp close($conn); 
?> 


俞 出 : 


90 


PHP ftp get() 函数 


定义 和 用 法 
ftp get() KM FTP 服务 器 上 下 载 一 个 文件 。 
若 成 功 则 返回 true， 失 败 则 返回 false. 


语法 


ftp get(ftp connection, local, remote, mode, resume) 





参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
local 必需 。 规 定 本 地 文件 。 
remote 必需 。 规 定 从 中 进行 拷贝 的 文件 的 路 径 。 
mode 必需 。 规 定 传输 模 式 。 可 能 的 值 有 : FTP_ASCII FTP_BINARY 
resume 必需 。 规 定 在 远程 文件 中 的 何 处 开始 拷贝 。 上 默认 是 0。 


说 明 


参数 resume 仅 适用 于 PHP 4.3.0 以 上 版 本 


例子 
本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp get($conn, "target.txt","source.txt",FTP ASCII); 


ftp close($conn); 
?> 


俞 出 : 


W3School PHP 参考 手册 


PHP ftp get() 画 数 440 


PHP ftp login() 函数 


定义 和 用 法 


ftp login() HAS x FTP 服务 器 。 


若 成 功 则 返回 trtue， 失 败 则 返回 false 并 发 出 一 个 警告 。 
语法 
ftp login(ftp connection, username, password) 
参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
username 必需 。 规 定 用 于 登录 的 用 户 名 。 
password 必需 。 规 定 用 于 登录 的 密码 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

ftp close($conn), 

?> 


PHP ftp mdtm() Hz 
定义 和 用 法 

ftp. mdtm() 本 数 返回 指定 文件 的 最 后 修改 时 间 。 
语法 


ftp login(ftp connection,file) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
file 必需 。 规 定 要 检查 的 文件 。 


提示 和 注释 
注释 : 并 非 所 有 FTP 服务 器 都 支持 该 函数 。 
注释 : 该 荡 数 不 适用 于 检查 目录 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

$mod = ftp mdtm($conn, "test.txt"), 

// 以 Unix 时 间 惟 返回 结果 

echo $mod; 

echo "<br />"; 


//18 Unix 时 间 戳 格式 化 为 日 其 
echo date(DATE RFC822, $mod), 


ftp close($conn), 
?> 


俞 出 : 


1140082571 
Thu, 16 Feb 2006 10:36:11 CET 


PHP ftp mkdir() 函数 
定义 和 用 法 

ftp mkdir() 函数 在 FTP 服务 器 上 建立 新 目录 。 
语法 


ftp mkdir(ftp connection,dir) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
dir 必需 。 规 定 要 创建 的 目录 的 名 称 。 


说 明 
在 FTP 服务 器 上 建立 一 个 目录 名 为 参数 dir 的 新 目录 。 
如 果 成 功 ， 则 返回 新 建 的 目录 名 ， 否 则 返回 false. 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp mkdir($conn, "testdir"), 


ftp close($conn), 
?> 


输出 : 


/testdir 


PHP ftp nb continue() Až 


定义 和 用 法 
ftp nb continue() 函数 连续 获取 / 发 送 文件 。 


PERRI) F 20) : 


e FTP FAILED (send/receive failed) 
e FTP FINISHED (send/receive completed) 
e FTP MOREDATA (send/receive in progress) 


该 函数 异步 地 发 送 /获取 文件 。 这 意味 着 您 的 程序 可 以 在 文件 下 载 时 执行 其 他 操作 。 
语法 
ftp nb continue(ftp connection) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


例子 


<?php 
$source = "source.txt"; 
$target - fopen("target.txt", "w"); 


$conn - ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


$status - ftp nb fget($conn, $source, $target,FTP ASCII); 
while ($status -- FTP MOREDATA) 


$status - ftp nb continue($conn), 


} 
if ($status != FTP_FINISHED) 


echo "Download error"; 


} 


ftp_close($conn); 
?> 


PHP ftp nb fget() 函数 


定义 和 用 法 

ftp nb fget() E32X AA FTP 服务 器 上 下 载 一 个 文件 并 保存 到 本 地 已 经 打开 的 一 个 文件 中 (non- 
blocking). 

ZHBIRE FIM : 


e FTP_FAILED (send/receive failed) 
e FTP_FINISHED (send/receive completed) 
e FTP_MOREDATA (send/receive in progress) 


与 ftp fget() 不 同 ， 该 图 数 异 步 地 获取 文件 。 这 意味 着 您 的 程序 可 以 在 文件 下 载 时 执行 其 他 操 
作 。 


语法 


ftp nb fget(ftp connection, local, remote, mode, resume) 





2 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) o 
local 必需 。 规 定 本 地 文件 。 
remote 必需 。 规 定 从 中 进行 拷贝 的 文件 的 路 径 。 
mode 必需 。 规 定 传 输 模式 。 可 能 的 值 有 月 : FTP_ASCII FTP_BINARY 
resume 必需 。 规 定 在 远程 文件 中 的 何 处 开始 拷贝 。 上 默认 是 0。 


例子 


本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 


<?php 
$source 
$target 


"source.txt"; 
fopen("target.txt", "w"); 


$conn - ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp nb fget($conn, $target, $source,FTP ASCII); 


ftp close($conn), 
?> 


PHP ftp nb put() 2X 


定义 和 用 法 
ftp nb put() 画 数 把 文件 上 传 到 服务 器 (non-blocking). 


KAORE FIJ : 


e FTP FAILED (send/receive failed) 
e FTP FINISHED (send/receive completed) 
e FTP MOREDATA (send/receive in progress) 


5 ftp put) TA, KAŠU Hk Bot. REBRA n] EEUU i nd dut EUER 
VF, 


ftp nb fput(ftp connection, remote, local, mode, resume) 


BY 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) o 
remote 必需 。 上 传 到 服务 器 上 的 文件 名 。 
local 必需 。 规 定 要 上 传 的 本 地 文件 的 路 径 。 
需 
需 


。 规 定 传输 模式 。 可 能 的 值 有 : FTP_ASCII FTP BINARY 
。 规 定 在 本 地 文件 中 的 何 处 开始 拷贝 。 默 认 是 0。 


mode WF 


resume WO Fn 


例子 
本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

ftp nb put($conn, "target.txt","source.txt",FTP ASCII); 


ftp close($conn); 
?> 


PHP ftp nlist() 函数 


定义 和 用 法 
ftp_nlist() 范 数 返回 指定 目录 的 文件 列表 。 
如 果 成 功 ， 则 返回 给 定 目 录 下 的 文件 名 组 成 的 数组 ， 否 则 返回 false. 


语法 


ftp nlist(ftp connection,dir) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
dir 必需 。 规 定 要 检查 的 目录 。 使 用 "." 来 获得 当前 目录 。 


提示 和 注释 


注释 : 该 画 数 不 适 用 于 IIS (Internet Information Server)。 它 返回 nothing. 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


print r(ftp nlist($conn, "images")), 


ftp close($conn); 
?> 


输出 类 似 : 


array(3) 


[0]=> "flower.gif" 
[1]-> "car.gif" 
[2]=> "house.gif" 
J 


PHP ftp pasv() Ea 


定义 和 用 法 
ftp pasv() 函数 把 被 动 模式 设置 为 打开 或 关闭 。 


在 被 动 模式 中 ， 数 据 连 接 是 由 客户 机 来 初始 化 的 ， 而 不 是 服务 器 。 这 在 客户 机 位 于 防火 墙 之 
后 时 比较 有 用 。 


语法 


ftp pasv(ftp connection, mode) 


参数 描述 
ftp connection ”必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


必需 。 规 定 模 式 。 TRUE = passive mode on FALSE = passive mode 
off 


mode 
说 明 
如 果 参 数 mode 为 真 ， 打 开 被 动 模式 传输 (PASV MODE), ， 否 则 ， 如 果 参 数 mode 为 假 ， 则 


关闭 被 动 传输 模式 。 在 被 动 模式 打开 的 情况 下 ， 数 据 的 传送 由 客户 机 启动 ， 而 不 是 由 服务 器 
开始 。 


如 果 成 功 则 返回 true， 失 败 则 返回 false. 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

ftp pasv($conn, TRUE), 


ftp close($conn); 
?> 


PHP ftp put() 函数 


定义 和 用 法 
ftp_put() 函数 把 文件 上 传 到 服务 器 。 


若 成 功 则 返回 true， 失 败 则 返回 false. 
语法 


ftp put(ftp connection, remote, local, mode, resume) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
remote 必需 。 上 传 到 服务 器 上 的 文件 名 。 
local 必需 。 规 定 要 上 传 的 本 地 文件 的 路 径 。 
mode 必需 。 规 定 传 输 模式 。 可 能 的 值 有 月 : FTP_ASCII FTP_BINARY 
resume 必需 。 规 定 在 本 地 文件 中 的 何 处 开始 拷贝 。 上 默认 是 0。 


例子 
本 例 把 文本 从 "source.txt" 拷贝 到 "target.txt" 中 : 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp put($conn, "target.txt", "source.txt",FTP ASCII); 


ftp close($conn), 
?> 


输出 : 


PHP ftp pwd() 函数 


定义 和 用 法 


ftp pwd() 函数 返回 当前 目录 名 。 


ftp_pwd(ftp_connection) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


// 输出 当前 目录 
echo ftp_pwd($conn) . "<br /»"; 


// 把 目录 改 为 images 
ftp_chdir($conn, "images"); 


// 输出 当前 目录 
echo ftp_pwd($conn); 


ftp close($conn), 
?> 


PHP ftp quit() 2X 


定义 和 用 法 
ftp_quit() BAX ja] FTP 连接 。 


该 事 数 关闭 给 出 的 连接 标识 符 并 释放 资源 。 
语法 


ftp_quit(ftp_connection) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


提示 和 注释 


提示 : 该 函数 是 ftp close() 函数 的 别名 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 


// 要 执行 的 一 些 代 码 


ftp guit($conn), 
?> 


PHP ftp raw() 函数 
定义 和 用 法 

ftp raw() 函数 向 FTP 服务 器 发 送 一 个 raw 命令 。 
语法 


ftp raw(ftp connection, command) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
command 必需 。 规 定 要 执行 的 命令 。 


提示 和 注释 


注释 : 该 函数 以 字符 串 数 组 的 形式 返回 服务 器 的 响应 。 不 执行 解析 ， 且 ftp_raw() 不 检查 命令 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 


print r (ftp raw($conn, "USER admin")); 
print r (ftp raw($conn, "PASS ert456")); 


ftp close($conn), 
?> 


输出 : 


Array ([0] => 331 User admin, password please) 
Array ([0] -» 230 Password Ok, User logged in) 


PHP ftp rawlist() E325 
定义 和 用 法 

ftp rawlist() 函数 返回 指定 目录 中 文件 的 详细 列表 。 
语法 


ftp rawlist(ftp connection,dir,recursive) 


参数 描述 
ftp connection ”必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
dir 必需 。 规 定 目录 。 使 用 "." 来 规定 当前 目录 。 


可 选 。 默 认 地 ， 该 琅 数 向 服务 器 发 送 "LIST" 命令 。 如 果 ， 如 果 


recursive n Ň 、 OM " 
recursive 参数 设置 为 true， 则 发 送 "LIST -R" $545. 


说 明 
ftp rawlist() HËFT FTP LIST 命令 ， 并 把 结果 返回 为 一 个 数组 。 数 组 的 每 个 元 素 为 返回 
文本 的 每 一 行 ， 输 出 结构 不 会 被 解析 。 


使 用 函数 ftp systype() 可 以 用 来 判断 FTP 服务 器 的 类 型 ， 从 而 可 以 用 来 判断 返回 列表 的 类 
型 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

print r (ftp rawlist($conn,".")); 


ftp close($conn), 
?> 


输出 类 似 : 


dr--r--r-- 
dr--r--r-- 
drw-rw-rw- 
-rW-rw-rw- 
-rW-rw-rw- 


user group 
user group 
user group 
user group 
user group 


© Feb 15 13:02 

© Feb 15 13:02 

© Jan 03 08:33 images 

160 Feb 16 13:54 test.php 
20 Feb 14 12:22 test.txt 


PHP ftp rename() E325 


定义 和 用 法 
ftp rename() HAEA FTP 服务 器 上 的 文件 或 目录 名 。 
如 果 成 功 ， 则 返回 true, AIRE false. 


语法 


ftp rename(ftp connection, from, to) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
from 必需 。 规 定 要 改名 的 文件 或 目录 。 
to 必需 。 规 定 文件 或 目录 的 新 名 称 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

ftp rename($conn, "oldname. txt", "newname.txt"), 


ftp close($conn); 
?> 


PHP ftp rmdir() HŽ 


sm > : 
ftp_rmdir() Bgm E&— ŇA ko 
如 果 成 功 ， 则 返回 true, AIRE false, 


语法 


ftp rmdir(ftp connection,dir) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
dir 必需 。 规 定 要 删除 的 目录 。 


说 明 
删除 由 参数 dir 指定 的 目录 。dir 必须 是 一 个 空 目 录 的 绝对 或 相对 路 径 。 
如 果 成 功 ， 则 返回 true， 否 则 返回 false. 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp rmdir($conn, "testdir"), 


ftp close($conn), 
?> 


PHP ftp set option() Až 
定义 和 用 法 
ftp set option() HU EA TR FTP 运行 时 选项 。 
语法 

ftp set option(ftp connection,option, value) 


参数 描述 
ftp connection ”必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


必需 。 规 定 要 删 设置 的 运行 时 选项 。 可 能 的 值 : FTP TIMEOUT SEC 


option FTP_AUTOSEEK 详细 信息 见 下 面 的 说 明 。 
value 必需 。 设 置 option 参数 的 值 。 


说 明 

FTP TIMEOUT SEC 选项 改变 网 络 传输 的 超时 时 间 。 参 数 value 必须 为 整数 且 大 于 0. Rid 
的 超时 时 间 为 90 秒 。 

当 FTP AUTOSEEK 选项 打开 时 ， 带 resumepos 或 startpos 参数 的 GET 或 PUT 请 求 将 先 
检索 到 文件 中 指定 的 位 置 。 此 选项 默认 是 打开 的 。 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp set option($conn, FTP TIMEOUT SEC, 120); 


ftp close($conn); 
?> 


PHP ftp site() HŽ 


定义 和 用 法 
ftp_site() AGAR 4-88 & 3€ SITE fp. 


SITE 命令 没有 标准 化 。 不 同 的 服务 器 不 尽 相 同 。 对 于 义理 文件 权限 或 组 关系 方面 的 事情 ， 
SITE 命令 很 有 用 。 


语法 


ftp site(ftp connection, command) 


参数 描述 
ftp_connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
command 必需 。 规 定向 FTP 发 送 的 SITE BR. 


说 明 
ftpsite() HR) FTP 服务 器 发 送 由 参数 _commandqd 指定 的 命令 。 
ix 


如 果 成 功 则 返回 true， 失 败 则 返回 false. 


提示 和 注释 


提示 : 如 需 查 看 哪些 命令 可 用 ， 请 通过 ftp_raw() HARK REMOTEHELP AD. 


例子 


<?php 
$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 


ftp site($conn, "CHMOD 0600 sitetest.txt"); 


ftp close($conn), 
?> 


PHP ftp size() 2X 
定义 和 用 法 

ftp size() 画 数 返回 指定 文件 的 大 小 。 
语法 


ftp size(ftp connection, remote file) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 
remote file 必需 。 规 定 要 检查 的 文件 。 


说 明 


ftpsize() 画 数 以 字 节 返回 远程 文件 _remote file 的 大 小 。 如 果 指 定 文 件 不 存在 或 发 生 错误 ， 则 
返回 -1。 有 些 FTP 服务 器 可 能 不 支持 此 特性 。 


如 果 获 取 成 功 ， 则 返回 文件 大 小 ， 否 则 返回 -1。 


提示 和 注释 


注释 : 并 非 所 有 FTP 服务 器 均 支持 该 落 数 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp size($conn, "test.txt"), 


ftp close($conn), 
?> 


qi EA : 


160 
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PHP ftp size() 2X 461 


PHP ftp ssl connect() 2X 


定义 和 用 法 
ftp_ssl_connect() 函数 打开 一 个 安全 的 SSL-FTP 连接 。 


当 连接 打开 ， 您 就 可 以 在 服务 器 运行 FTP BAK, 
语法 


ftp ssl connect(host, port, timeout) 


BR 描述 
lioet 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 可 以 是 域名 或 IP 地 
址 。 该 参数 不 能 包含 "ftp://" SX RAL. 
port 可 选 。 规 定 FTP 服务 器 的 端口 。 上 默认 是 21. 


timeout Fit, AE FTP 连接 的 超时 时 间 。 默 认 是 90 秒 。 


例子 


本 例 尝试 连接 一 个 FTP 服务 器 。 如 果 连 接 失 败 ，die() 画 数 会 终止 脚本 的 执行 ， 并 输出 一 条 消 
E: 


«?php 
$conn - ftp ssl connect("ftp.testftp.com") or die("Could not connect"); 
?> 


PHP ftp systype() 函数 


oo 、 : 
ftp systype() 范 数 返回 远程 FTP 服务 器 的 系统 类 型 标识 符 。 


该 图 数 返 回 远程 服务 器 的 系统 类 型 。 若 发 生 错误 ， 则 返回 false, 


语法 


ftp_systype(ftp_connection) 


参数 描述 
ftp connection 必需 。 规 定 要 使 用 的 FTP 连接 (FTP 连接 的 标识 符 ) 。 


例子 


<?php 

$conn = ftp connect("ftp.testftp.com") or die("Could not connect"); 
ftp login($conn, "admin", "ert456"), 

echo ftp systype($conn), 


ftp close($conn); 
?> 


输出 类 似 : 


UNIX 


PHP HTTP 函数 

PHP HTTP 简介 

HTTP WAH TER 49 HABLAR XX BU, STA web 服务 器 发 送 到 浏览 器 的 信息 
安装 

HTTP Wate PHP 核心 的 组 成 部 分 。 无 需 安 装 即 可 使 用 这 些 函 数 。 


PHP HTTP i2 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


函数 描述 
header() 向 客户 端 发 送 原始 的 HTTP 报头 。 
headers list() 返回 已 发 送 的 (或 待 发 送 的 ) 响应 头 部 的 一 个 列表 。 


headers_sent() 检查 HTTP 报头 是 否 发 送 /已 发 送 到 何人 处 。 
setcookie() 向 客户 端 发 送 一 个 HTTP cookie, 
setrawcookie() 不 对 cookie 值 进行 URL 编码 ， 发 送 一 个 HTTP cookie, 


进行 操作 。 


PHP 


a wo wo QC wm 


PHP header() 2% 


mo 、 S 
定义 和 用 法 
header() HAAZ P im AXIRI HTTP 报头 。 


认识 到 一 点 很 重要 ， 即 必须 在 任何 实际 的 输出 被 发 送 之 前 调用 header() HR (TE PHP 4 以 及 
更 高 的 版 本 中 ， 您 可 以 使 用 输出 缓存 来 解决 此 问题 ) 

<html> 

<?ph 

// 结果 出 错 

// 在 调用 header() 之 前 已 存在 输出 


header('Location: http://www.example.com/'); 
?> 


语法 


header(string, replace, http response code) 


参数 描述 
string 必需 。 规 定 要 发 送 的 报头 字符 串 。 


可 选 。 指 示 该 报头 是 否 替 换 之 前 的 报头 ， 或 添加 第 二 个 报头 。 默 
i true (#4) 。false (允许 相同 类 型 的 多 个 报头 ) 。 


可 选 。 把 HTTP 响应 代码 强制 为 指定 的 值 。 (PHP 4 以 及 更 高 版 
本 可 用 ) 


replace 


http response code 
日 一 RT £ 
提示 和 注释 
注释 : 从 PHP 4.4 之 后 ， 该 图 数 防止 一 次 发 送 多 个 报头 。 这 是 对 头 部 注入 攻击 的 保护 措施 。 


例子 
例子 1 


<?php 

// Date in the past 

header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); 
header("Cache-Control: no-cache"); 
header("Pragma: no-cache"); 

?» 


«html» 
«body» 


注释 : 用 户 可 能 会 设置 一 Po si ns 置 。 通 过 发 送 上 面 的 报头 ， 您 可 
LEG st 


以 覆盖 任何 这 些 设置 ， zA K 览 器 不 进行 缓存 ! 


例子 2 


提示 用 户 保存 一 个 生成 的 PDF 文件 (Content-Disposition 报头 用 于 提供 一 


并 强制 浏览 器 显示 保存 对 话 框 ) 


<?php 
header ("Content-type:application/pdf"); 


// 文件 将 被 称 为 downloaded. pdf 


header( "Content -Disposition:attachment; filename='downloaded.pdf'"); 


// PDF 源 在 original.pdf 中 
readfile("original.pdf"); 
?> 


<html> 
<body> 


个 推荐 的 文件 名 ， 


注释 : 微软 IE 5.5 存在 一 个 阻止 以 上 机 制 的 bug。 通 过 升级 为 Service Pack 2 或 更 高 的 版 


本 ， 可 以 解决 该 bug。 


PHP headers list() 2X 


= ~ M 
headers list() HAGREIE X XB (RE AXEBJ) 响应 头 部 的 一 个 列表 。 
该 画 数 返 回 包含 报头 的 数组 。 


语法 


headers list() 


提示 : 如 需 确 定 是 否 已 发 送 报头 ， 请 使 用 headers_sent() HR. 


例子 


<?php 

setcookie("TestCookie", "SomeValue"), 
header("X-Sample-Test: foo"); 
header('Content-type: text/plain'); 
?> 


<html> 
<body> 


<?php 

// 发 送 哪些 报头 ? 

var dump(headers list()); 
?> 


«/body» 
</html> 


PHP headers sent() 2X 


定义 和 用 法 


headers sent() 函数 检查 HTTP 标 头 是 否 已 被 发 送 以 及 在 哪里 被 发 送 。 


是 
如 果 报 头 已 发 送 ， 则 返回 true， 否 则 返回 false. 


语法 


headers sent( file , line ) 





参数 描述 
file line 可 选 。 如 果 设 置 je 和 line SW, headers sent() 会 把 输出 开始 的 PHP 源 文 


件 名 和 行 号 存 入 file 和 line 变量 中 。 


提示 和 注释 


注释 : 一 旦 报头 块 已 经 发 送 ， 就 不 能 使 用 header() 函数 来 发 送 其 它 的 标 头 。 使 用 此 本 数 至 少 
可 以 避免 与 HTTP 标 头 有 关 的 错误 信息 。 


注释 : 可 选 的 file 和 line 参数 是 PHP. 4.3 中 新 加 的 。 


例子 
例子 1 


<?php 
// 如 果 报头 未 发 送 ， 则 发 送 一 个 
if (!headers sent()) 


header ( "Location: http://www.w3school.com.cn/"); 
exit, 
} 


2» 


«html» 
«body» 


例子 2 
使 用 可 选 的 fle 和 line 参数 : 


<?php 

// 传递 $file 和 $line， 供 日 后 使 用 
// 不 要 预先 为 它们 赋值 

if (!headers sent($file, $line)) 


header ( "Location: http://www.w3school.com.cn/"); 
exit, 
// Trigger an error here 


} 


else 


echo "Headers sent in $file on line $line"; 
exit; 
} 


2» 


«html» 
«body» 


PHP setcookie() 函数 


= > N 
setcookie() HAA% Pí X 3$ — ^^ HTTP cookie, 


cookie 是 由 服务 器 发 送 到 浏览 器 的 变量 。cookie BEAR 4-28 Ex AIL FE P i SALA) CAS 
文件 。 每 当 计 算 机 通过 浏览 器 请 求 一 个 页 面 ， 就 会 发 送 这 个 cookie. 


cookie 的 名 称 指 定 为 相同 名 称 的 变量 。 例 如 ， 如 果 被 发 送 的 cookie 名 为 "name"， 会 自动 创 
建 名 为 $user 的 变量 ， 包 含 cookie 的 值 。 


必须 在 任何 其 他 输出 发 送 前 对 cookie 进行 赋值 。 


如 果 成 功 ， 则 该 函数 返回 true， 否 则 返回 false. 
语法 


setcookie(name, value, expire, path, domain, secure) 





参数 描述 
name 必需 。 规 定 cookie 的 名 称 。 
value 必需 。 规 定 cookie 的 值 。 
expire 可 选 。 规 定 cookie 的 有 效 期 。 
path 可 选 。 规 定 cookie 的 服务 器 路 径 。 
domain 可 选 。 规 定 cookie 的 域名 。 
secure 可 选 。 规 定 是 否 通过 安全 的 HTTPS 连接 来 传输 cookie。 


提示 和 注释 


注释 : 可 以 通过 $HTTP COOKIE VARS[user“] 或 $_ COOKIE["user"] 来 访问 名 为 "user" 的 
cookie 的 值 。 


注释 : 在 发 送 cookie 时 ，cookie 的 值 会 自动 进行 URL 编码 。 接 收 时 会 进行 URL 解码 。 如 果 
你 不 需要 这 样 ， 可 以 使 用 setrawcookie() RE, 


例子 


例子 1 
设置 并 发 送 cookie : 


<?php 
$value = "my cookie value", 


// 发 送 一 个 简单 的 cookie 
setcookie("TestCookie", $value); 
?> 


<html> 
<body> 


<?php 
$value - "my cookie value"; 


// 发 送 一 个 24 小 时 候 过 期 的 cookie 
setcookie("TestCookie",$value, time()+3600*24) ; 
?> 


<html> 
<body> 


例子 2 
检索 cookie 值 的 不 同方 法 : 


<html> 
<body> 


<?php 


// 输出 个 别 的 cookie 

echo $ COOKIE["TestCookie"]; 

echo "«br /»"; 

echo $HTTP COOKIE VARS["TestCookie"]; 
echo "«br /»"; 


// 输出 所 有 cookie 
print r($ COOKIE), 
?> 


</body> 
</html> 


输出 : 


my cookie value 
my cookie value 
Array ([TestCookie] -» my cookie value) 


例子 3 
通过 把 失效 日 期 设置 为 过 去 的 日 期 /时 间 ， 删 除 一 个 cookie : 


<?php 

// 把 失效 日 期 设置 为 一 小 时 前 

setcookie ("TestCookie", "", time() - 3600), 
?> 


<html> 
<body> 


例子 4 
创建 一 个 数组 cookie : 


<?php 

setcookie("cookie[three]", "cookiethree"), 
setcookie("cookie[two]", "cookietwo"), 
setcookie("cookie[one]", "cookieone"), 


// 输出 cookie (在 重 载 页 面 后 ) 
if (isset($ COOKIE["cookie"])) 
{ 
foreach ($_COOKIE["cookie"] as $name => $value) 
{ 
echo "$name : $value «br />"; 
J 
} 


?> 


<html> 
<body> 


输出 : 


three : cookiethree 
two : cookietwo 
one : cookieone 


PHP setrawcookie() HŽ% 


ch 、 : 
setrawcookie() tT x1 cookie 值 进行 URL 编码 ， 发 送 一 个 HTTP cookie. 


cookie 是 由 服务 器 发 送 到 浏览 器 的 变量 。cookie 通常 是 服务 器 嵌入 到 用 户 计算 机 中 的 小 文本 
文件 。 每 当 计 算 机 通过 浏览 器 请 求 一 个 页 面 ， 就 会 发 送 这 个 cookie, 


cookie 的 名 称 指 定 为 相同 名 称 的 变量 。 例 如 ， 如 果 被 发 送 的 cookie 名 为 "name"， 会 自动 创 
建 名 为 $user 的 变量 ， 包 含 cookie 的 值 。 


必须 在 任何 其 他 输出 发 送 前 对 cookie 进行 赋值 。 


如 果 成 功 ， 则 该 函数 返回 true， 否 则 返回 false. 
语法 


setcookie(name, value, expire, path, domain, secure) 





参数 描述 
name 必需 。 规 定 cookie 的 名 称 。 
value 必需 。 规 定 cookie 的 值 。 
expire 可 选 。 规 定 cookie 的 有 效 期 。 
path 可 选 。 规 定 cookie 的 服务 器 路 径 。 
domain 可 选 。 规 定 cookie 的 域名 。 
secure 可 选 。 规 定 是 否 通过 安全 的 HTTPS 连接 来 传输 cookie。 


提示 和 注释 


注释 : 可 以 通过 $HTTP COOKIE VARS[user“] 或 $_ COOKIE["user"] 来 访问 名 为 "user" 的 
cookie 的 值 。 


注释 : setrawcookie() 与 setcookie() 几乎 完全 相同 ， 不 同 的 是 不 会 在 发 往 客户 机 时 ， 对 
cookie 值 进行 自动 URL 编码 。 


例子 


例子 1 
设置 并 发 送 cookie : 


<?php 
$value = "my cookie value", 


// 发 送 一 个 简单 的 cookie 
setrawcookie("TestCookie", $value), 
?> 


<html> 
<body> 


<?php 
$value - "my cookie value"; 


// 发 送 一 个 24 小 时 候 过 期 的 cookie 
setrawcookie("TestCookie",$value, time()+3600*24); 
?> 


<html> 
<body> 


例子 2 
检索 cookie 值 的 不 同方 法 : 


<html> 
<body> 


<?php 


// 输出 个 别 的 cookie 

echo $ COOKIE["TestCookie"]; 

echo "«br /»"; 

echo $HTTP COOKIE VARS["TestCookie"]; 
echo "«br /»"; 


// 输出 所 有 cookie 
print r($ COOKIE), 
?> 


</body> 
</html> 


输出 : 


my cookie value 
my cookie value 
Array ([TestCookie] -» my cookie value) 


例子 3 
通过 把 失效 日 期 设置 为 过 去 的 日 期 /时 间 ， 删 除 一 个 cookie : 


<?php 

// 把 失效 日 期 设置 为 一 小 时 前 

setrawcookie ("TestCookie", "", time() - 3600); 
?> 


<html> 
<body> 


例子 4 
创建 一 个 数组 cookie : 


<?php 

setrawcookie("cookie[three]", "cookiethree"), 
setrawcookie("cookie[two]", "cookietwo"), 
setrawcookie("cookie[one]", 'cookieone"); 


// 输出 cookie (在 重 载 页 面 后 ) 
if (isset($ COOKIE["cookie"])) 
{ 
foreach ($_COOKIE["cookie"] as $name => $value) 
{ 
echo "$name : $value «br />"; 
J 
} 


?> 


<html> 
<body> 


输出 : 


three : cookiethree 
two : cookietwo 
one : cookieone 


PHP libxml 函数 


PHP libxml 简介 
libxml HAA SS SimpleXML, XSLT LAR DOM 一 起 使 用 。 
BOR 

EAS libxml 程序 包 。 在 xmlsoft.org F 3X. 


PHP libxml 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


函数 描述 
libxml_clear_errors() 清空 libxml 错误 缓冲 。 
libxml get errors() 检索 错误 数组 。 
libxml get last error() M libxml 检索 最 后 的 错误 。 


libxml set streams context() ”为 下 一 次 libxml 文档 加 载 或 宇 入 设置 流 环境 。 
禁用 libxml 错误 ， 人 允许 用 户 按 需 读 取 错误 信 


IONO 


libxml use internal errors() 


PHP libxml 常量 


PHP 


LIBXML COMPACT 


LIBXML DTDATTR 
LIBXML DTDLOAD 
LIBXML DTDVALID 
LIBXML NOBLANKS 
LIBXML NOCDATA 


LIBXML NOEMPTYTAG 


LIBXML_NOENT 
LIBXML_NOERROR 
LIBXML_NONET 
LIBXML_NOWARNING 
LIBXML_NOXMLDECL 
LIBXML_NSCLEAN 
LIBXML_XINCLUDE 
LIBXML_ERR_ERROR 
LIBXML_ERR_FATAL 
LIBXML_ERR_NONE 
LIBXML_ERR_WARNING 
LIBXML_VERSION 


LIBXML_DOTTED_VERSION 


描述 


ars 
ae X 


设置 默认 DTD 属性 。 

加 载 外 部 子 集 。 

通过 DTD 进行 验证 。 
删除 空 节 点 。 

把 CDATA 设置 为 文本 节点 。 


更 改 空 标签 (比如 <br/> 改 为 <br></br>) 。 
仅 在 DOMDocument->save() 和 
DOMDocument->saveXML() 函数 中 可 用 。 


蔡 代 实体 。 

不 显示 错误 报告 。 

在 加 载 文档 时 停止 网 络 访问 。 
不 显示 警告 报告 。 

在 保存 文档 时 ， 撤 销 XML 声明 。 
删除 额外 的 命名 空间 声明 。 
使 用 XInclude 置换 。 
获得 可 恢复 的 错误 。 


获得 libxml 版 本 (例如 : 20605 或 20617) 。 


获得 有 点 号 的 libxml 版 本 (例如 : 2.6.5 或 
2:6 167 


设置 小 型 节点 分 配 优化 。 会 改善 应 用 程序 的 性 


PHP 


Cie) c [Ori] Gi mno 01 


01 


PHP libxml clear errors() 函数 
定义 和 用 法 

libxml clear errors() 函数 清空 libxml 错误 缓冲 。 

语法 


libxml clear errors() 


例子 


<?ph 
libxml clear errors() 
?> 


PHP libxml get errors() HŽ 


Ho. : 
定义 和 用 法 
libxml get errors() 函数 从 libxml 错误 缓冲 中 获取 错误 。 


该 图 数 返 回 错 误 对 象 的 一 个 数组 ， 如 果 libxml 错误 缓冲 中 没有 错误 ， 则 返回 一 个 空 数组 。 
语法 


libxml get errors() 


例子 


<?php 
libxml get errors() 
?> 


PHP libxml get last error() 2X 


= : 
libxml get last error() 函数 从 libxml 错误 缓冲 中 获取 最 后 一 个 错误 。 


若 成 功 ， 则 返回 一 个 错误 对 象 。 若 失败 ， 或 libxml 错误 缓冲 中 没有 错误 ， 则 返回 false. 
语法 


libxml get last error() 


例子 


<?php 
libxml get last error() 
?> 


PHP libxml use internal errors() 2% 
定义 和 用 法 

libxml use internal errors() KAS FA ta £89 libxml 错误 ， 并 启用 用 户 错误 处 理 。 
语法 


libxml use internal errors(user errors) 


BR 描述 
user errors 可 选 。 规 定 是 否 应 该 启用 用 户 错误 处 理 。 默 认 是 false。 


说 明 


该 图 数 返 回 user errors 参数 之 前 的 值 。 


<?php 
libxml use internal errors() 
?> 


PHP Mail 函数 


PHP Mail 简介 
HTTP RSC i MA Fn Er B E, nr tb, 


BEHRA, PHP 需要 已 安装 且 正 在 运行 的 邮件 系统 。 要 使 用 的 程序 是 由 php.ini 文件 
中 的 配置 设置 定义 的 。 


安装 
邮件 函数 是 PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 函 数 。 
运行 时 配 秆 

ERRET A Æ php.ini 的 影响 。 


Mail 配置 选项 


名 称 默认 描述 可 更 改 
SMTP "localhost" O LUE PHP INI ALL 
smtp. port "25" RT > E PHP INI ALL 

Windows 专用 : 规定 从 PHP X PHP. INI ALL 


sendmail from — NULL 送 的 邮件 中 使 用 的 "from" 地 址 。 


Unix 系统 专用 : 规定 sendmail 
程序 的 路 径 (通常 
/usr/sbin/sendmail 或 
lusr/lib/sendmail) 


sendmail path NULL PHP INI SYSTEM 


PHP Mail 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


V3School PHP 参考 手册 

AX 描述 
ezmlm hash() 计算 EZMLM 邮件 列表 系统 所 需 的 散 列 值 。 
mail() 人 允许 您 从 脚本 中 直接 发 送 电子 邮件 。 


PHP Mail 函数 


PHP 


AQ2 
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PHP mail() 函数 


定义 和 用 法 
mail() 函数 允许 您 从 脚本 中 直接 发 送 电 子 邮 件 。 
如 果 邮 件 的 投递 被 成 功 地 接收 ， 则 返回 true， 否 则 返回 false. 





参数 描述 
to 必需 。 规 定 邮 件 的 接收 者 。 
subject 必需 。 规 定 邮 件 的 主题 。 该 参数 不 能 包含 任何 换行 字符 。 
message 必需 。 规 定 要 发 送 的 消息 。 
headers 必需 。 规 定额 外 的 报头 ， 上 比如 From, Ce LAR Bec. 
parameters 必需 。 规 定 sendmail 程序 的 额外 参数 。 
说 明 


在 message 参数 规定 的 消息 中 ， 行 之 间 必 须 以 一 个 LF (An) 分 隔 。 每 行 不 能 超过 70 DF 
符 。 


(Windows F) 当 PHP 直接 连接 到 SMTP 服务 器 时 ， 如 果 在 一 行 开 头发 现 一 个 句号 ， 则 会 
被 删 掉 。 要 避免 此 问题 ， 将 单个 句号 替换 成 两 个 句号 。 


<?php 
$text = str replace("An.", "\n..", $text); 
?> 


提示 和 注释 
注释 : 您 需要 晨 记 ， 邮 件 投 着 被 接受 ， 并 不 意味 着 邮件 到 达 了 计划 的 目的 地 。 


例子 


例子 1 
发 送 一 封 简单 的 邮件 : 


<?php 
$txt = "First line of text\nSecond line of text"; 


// 如 果 一 行 大 于 70 个 字符 ， 请 使 用 wordwrap ( )。 
$txt = wordwrap($txt, 70); 


// 发 送 邮件 


mail("somebodyQexample.com","My subject", $txt); 
?> 


例子 2 
发 送 带 有 额外 报头 的 email : 


<?php 


$to = "somebodyQexample.com"; 

$subject - "My subject"; 

$txt - "Hello world!"; 

$headers = "From: webmasterQexample.com" . "\r\n" 
"CC: somebodyelse@example.com"; 


mail($to, $subject, $txt, $headers); 
?» 


例子 3 


发 送 一 封 HTML email : 


<?php 


$to = "somebodyQexample.com, somebodyelseQexample.com"; 
$subject - "HTML email"; 


$message - " 

«html» 

«head» 

<title>HTML email</title> 
</head> 

<body> 

<p>This email contains HTML Tags!</p> 
<table> 

<tr> 

<th>Firstname</th> 
<th>Lastname</th> 

</tr> 

<tr> 

<td>John</td> 
<td>Doe</td> 

</tr> 

</table> 

</body> 

«/html» 


"e. 
, 


// AR HTML 电子 邮件 时 ， 请 始终 设置 content-type 


$headers = "MIME-Version: 1.0" . "\r\n"; 

$headers .= "Content-type: text/html; charset=iso-8859-1" 
// 更 多 报头 

$headers .= "From: <webmaster@example.com>' . "\r\n"; 
$headers .= "Ce: mybossQexample.com' . "\r\n"; 


mail($to, $subject, $message, $headers); 
?» 


ANITA 


PHP Math 函数 


PHP Math 简介 
数学 (Math) 函数 能 处 理 integer 和 float 范围 内 的 值 。 


rx 


RR 


数学 (Math) 函数 是 PHP MON ZA pK EBAY. TREBA n] fs FH ix He, 


PHP Math 函数 
PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 
EA 描述 PHP 
abs() 绝对 值 。 3 
acos() RREZ 3 
acosh() 反 双 曲 余弦 。 4 
asin() RIE AK. 3 
asinh() Bc RBH IE aK. 4 
atan() 反正 切 。 3 
atan2() 两 个 参数 的 反正 切 。 3 
atanh() 反 双 曲 正 切 。 4 
base_convert() 在 任意 进 制 之 间 转 换 数字 。 3 
bindec() 把 二 进 制 转换 为 十 进 制 。 3 
ceil() 向 上 舍 入 为 最 接近 的 整数 。 3 
cos() Rko 3 
cosh() 双 曲 余弦 。 4 
decbin() 把 十 进 制 转换 为 二 进 制 。 3 
dechex() 把 十 进 制 转换 为 十 六 进 制 。 3 
decoct() 把 十 进 制 转换 为 八进制 。 3 
deg2rad() 将 角度 转换 为 弧度 。 3 


W3School PHP 参考 手册 


exp() 返回 E<sup>x</sup> 的 值 。 3 
expm1() 返回 E<sup>x</sup> - 1 的 值 。 4 
floor() 向 下 舍 入 为 最 接近 的 整数 。 3 
fmod() 返回 除法 的 浮 点 数 余数 。 4 
getrandmax() 显示 随机 数 最 大 的 可 能 值 。 3 
hexdec() 把 十 六 进 制 转换 为 十 进 制 。 3 
hypot() 计算 直角 三 角形 的 斜 边 长 度 。 4 
is finite() 判断 是 否 为 有 限 值 。 4 
is infinite() 判断 是 否 为 无 限 值 。 4 
is nan() 判断 是 否 为 合法 数值 。 4 
Icg value() 返回 范围 为 (0, 1) 的 一 个 伪 随 机 数 。 4 
log() 自然 对 数 。 3 
log10() 以 10 为 底 的 对 数 。 3 
log1p() 返回 log(1 + number), 4 
max() 返回 最 大 值 。 3 
min() 返回 最 小 值 。 3 
mt getrandmax() 显示 随机 数 的 最 大 可 能 值 。 3 
mt rand() 使 用 Mersenne Twister 算法 返回 随机 整数 。 3 
mt. srand() 播种 Mersenne Twister 随机 数 生 成 器 。 3 
octdec() 把 八进制 转换 为 十 进 制 。 3 
pi() 返回 圆周 率 的 值 。 3 
pow() 返回 x 的 y 次 方 。 3 
rad2deg() 把 弧度 数 转换 为 角度 数 。 3 
rand() 返回 随机 整数 。 3 
round() 对 浮 点 数 进行 四 舍 五 入 。 3 
sin() 正弦 。 3 
sinh() 双 曲 正弦 。 4 
sgrt() 平方 根 。 3 
srand() 播 下 随机 数 发 生 器 种 子 。 3 
tan() 正切 。 3 
tanh() 双 曲 正切 。 4 
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常量 名 


M_E 
M_EULER 
M_LNPI 
M_LN2 
M_LN10 
M_LOG2E 


M LOG10E 


M PI 
M PI 2 
M PI 4 
M 1 PI 
M 2 PI 
M SQRTPI 


M 2 SQRTPI 
M SQRT1 2 


M SQRT2 
M SQRT3 


常量 名 
e 
Euler 常量 
log e(pi) 
log e2 
log e 10 
log 2e 
log 10e 
PI 
pi/2 
pi/4 
1/pi 
2/pi 


常量 值 
2.7182818284590452354 
0.57721566490153286061 
1.14472988584940017414 
0.69314718055994530942 
2.30258509299404568402 
1.4426950408889634074 
0.43429448190325182765 
3.14159265358979323846 
1.57079632679489661923 
0.78539816339744830962 
0.31830988618379067154 
0.63661977236758134308 
1.77245385090551602729 
1.12837916709551257390 
0.70710678118654752440 
1.41421356237309504880 
1.73205080756887729352 


PHP abs() eax 


定义 和 用 法 


abs() 函数 返回 一 个 数 的 绝对 值 。 


语法 
abs(x) 
参数 描述 
X 必需 。 一 个 数 。 
说 明 


返回 参数 x 的 绝对 值 。 如 果 参 数 x 是 float， 则 返回 的 类 型 也 是 float， 否 则 返回 integer (因为 
float 通常 比 integer 有 更 大 的 取 值 范围 ) 。 


例子 


<?php 
echo(abs(6.7)); 
echo(abs(-3)); 
echo(abs(3)); 
?> 


PHP acos() KŻ 


定义 和 用 法 


acos() 函数 返回 一 个 数 的 反 余 弦 。 


语法 
acos(x) 
参数 描述 
X 必需 。 一 个 数 ， 范围 在 -1 到 1 之 间 。 


说 明 
返回 x 的 反 余弦 值 ， 单 位 是 弧度 。acos() 是 cos() 的 反 函 数 ， 它 的 意思 是 在 acos() 范围 里 的 
每 个 值 都 是 a--cos(acos(a)) . 


如 果 x 的 值 在 -1 到 1 之 外 ， 则 返回 -1.#IND. WRA -1, NRE PI 的 值 。 


例子 
在 本 例 中 ， 我 们 将 计算 不 同 值 的 反 余弦 : 


<?php 
echo(acos(0.64)); 
echo(acos(0)); 
echo(acos(-1)); 
echo(acos(1)); 
echo(acos(2)); 

?> 


输出 : 


0.876298061168 
1.57079632679 
3.14159265359 


© 
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PHP acosh() 函数 


定义 和 用 法 
acosh() 函数 返回 一 个 数 的 反 双 曲 余 弦 。 
语法 
acosh(x) 
参数 
X 必需 。 一 个 数 。 
说 明 


返回 x 的 反 双 曲 余弦 值 ， 即 ， 其 双 曲 余弦 为 x 的 那个 值 。 


提示 和 注释 


注释 : AWAKE Windows 平台 下 实现 。 


PHP asin() 函数 


定义 和 用 法 


asin() 函数 返回 不 同 数值 的 反正 弦 ， 返 回 的 结果 是 介 于 -PI/2 与 Pl/2 之 间 的 弧度 值 。 


语法 
asin(x) 
参数 描述 
X 必需 。 一 个 数 ， 范围 在 -1 到 1 之 间 。 


说 明 


返回 x 的 反正 弦 值 ， 单 位 是 弧度 。asin() 是 sin) 的 反 函 数 ， 它 的 意思 是 在 asin() 范围 里 的 每 
个 值 都 是 a==sin(asin(a))。 


如 果 x 的 值 在 -1 到 1 之 外 ， 则 返回 -1. 烛 ND。 如 果 为 1， 则 返回 PI/2 的 值 。 


例子 
在 本 例 中， 我 们 将 计算 不 同 值 的 反正 纺 : 


<?php 
echo(asin(0.64)); 
echo(asin(0)); 
echo(asin(-1)); 
echo(asin(1)); 
echo(asin(2)) 

?> 


输出 : 


0.694498265627 
© 
-1.57079632679 
1.57079632679 
-1.#IND 


PHP asinh() 函数 


定义 和 用 法 
asinh() 函数 返回 一 个 数 的 反 双 曲 正 弦 。 
语法 
asinh(x) 
参数 
X 必需 。 一 个 数 。 
说 明 


返回 x 的 反 双 曲 正弦 值 ， 即 ， 其 双 曲 正弦 为 x 的 那个 值 。 


提示 和 注释 


注释 : AWAKE Windows 平台 下 实现 。 


PHP atan() 和 atan2() 函数 


a 、 M 
atan() HÄ RE — 44 ARIE, READ T -PI/2 与 PU2 之 间 。 


atan2() 函数 返回 两 个 参数 的 反正 切 ， 返 回 值 为 弧度 ， 其 值 在 -P| 和 PI 之 间 (包括 -PI 和 
PI) o 


语法 


atan(x) 


atan2(x, y) 


参数 描述 


说 明 


atan() HORE] x 的 反正 切 值 ， 单 位 是 弧度 。atan() 是 tan) HRA, EHŠÉBET atan() 
范围 里 的 每 个 值 都 是 a==tan(atan(a))。 


atan2() 图 数 计算 两 个 变量 x 和 的 反正 切 值 。 和 计算 y /x 的 反正 切 相似 ， 不 同 的 是 两 个 参 
数 的 符号 是 用 来 确定 结果 的 象限 之 外 。 


例子 1 
本 例 计 算 不 同 值 的 反正 切 : 


<?php 
echo(atan(0.50)); 
echo(atan(-0.50)); 
echo(atan(5)); 
echo(atan(10)); 
echo(atan( -5)); 
echo(atan( -10)) 

?> 


输出 : 


0.463647609001 
-0.463647609001 
1.37340076695 
1.4711276743 
-1.37340076695 
-1.4711276743 


例子 2 


本 例 计 算 不 同 的 变量 x fü y 的 反正 切 值 : 


<?php 
echo(atan2(0.50,0.50)); 
echo(atan2(-0.50, -0.50)); 
echo(atan2(5,5)); 
echo(atan2(10,20)); 
echo(atan2(-5, -5)); 
echo(atan2(-10,10)) 

?> 


输出 : 


0.785398163397 
-2.35619449019 
0.785398163397 
0.463647609001 
-2.35619449019 
-0.785398163397 


PHP atanh() 函数 


i 、 N 
atanh() 函数 返回 一 个 角度 的 反 双 曲 正 切 。 
语法 
atanh(x) 
参数 描述 
X 必需 。 一 个 数 。 
说 明 


atanh() HORE x 的 反 双 曲 正切 值 ， 即 ， 其 双 曲 正切 为 x 的 那个 值 。 


提示 和 注释 


注释 : AWAKE Windows 平台 下 实现 。 


PHP base convert() 2X 
定义 和 用 法 

base convert() 函数 在 任意 进 制 之 间 转 换 数字 。 
语法 


base_convert(number, frombase, tobase) 


参数 描述 
number 必需 。 原 始 值 。 
frombase 必需 。 数 字 原 来 的 进 制 。 
tobase 必需 。 要 转换 的 进 制 。 
说 明 


返回 一 个 字符 串 ， 包 含 number 以 tobase 进 制 的 表示 。mumber 本 身 的 进 制 由 frombase 18 
iE. frombase 和 tobase 都 只 能 在 2 和 36 Zid (包括 2 和 36) 。 高 于 十 进 制 的 数字 用 字母 
a-z 表示 ， 例 如 a 表示 10, b 表示 11 以 及 二 表示 35。 


例子 1 


把 八进制 数 转换 为 十 进 制 数 : 


<?php 
$oct = "0031" 
$dec = base Bee rere so 8,10); 


echo "八进制 的 $oct 等 于 十 进 制 的 $dec, " 


?> 


输出 : 


八进制 的 0031 等 于 十 进 制 的 25。 


例子 2 


把 八进制 数 转换 为 十 六 进 制 数 : 


<?php 
$oct = "364"; 
$hex = base_convert($oct, 8,16); 


echo "八进制 的 $oct 等 于 十 六 进 制 的 $hex, ": 


2» 


输出 : 


八进制 的 364 等 于 十 六 进 制 的 f4。 


PHP bindec() E23 
定义 和 用 法 

bindec() 函数 把 二 进 制 转换 为 十 进 制 。 
语法 


bindec(binary_string) 


参数 描述 
binary_string 必需 。 规 定 要 转换 的 二 进 制 数 。 


说 明 
返回 binary_string 参数 所 表示 的 二 进 制 数 的 十 进 制 等 价值 。 


bindec() 函数 闻 一 个 二 进 制 数 转换 成 integer。 可 转换 的 最 大 的 数 为 31 位 1 或 者 说 十 进 制 的 
2147483647, PHP 4.1.0 开始 ， 该 函数 可 以 处 理 大 数值 ， 这 种 情况 下 ， 它 会 返回 float 类 型 。 


例子 


<?php 

echo bindec("0011"); 

echo bindec("01"); 

echo bindec("11000110011"); 
echo bindec("111"); 

?> 


输出 : 


PHP ceil() KŻ 


定义 和 用 法 


ceil() KAASA ARERR 


语法 
ceil(x) 
BR 描述 
x 必需 。 一 个 数 。 


说 明 


返回 不 小 于 x 的 下 一 个 整数 ，x 如 果 有 小 数 部 分 则 进 一 位 。ceil() 返回 的 类 型 仍然 是 float， 
为 float 值 的 范围 通常 比 integer 要 大 。 


例子 
在 本 例 中 ， 我 们 将 对 不 同 的 值 应 用 ceil() BRAK : 


<?php 
echo(ceil(0.60); 
echo(ceil(0.40); 
echo(ceil(5); 
echo(ceil(5.1); 
echo(ceil(-5.1); 
echo(ceil(-5.9)); 
?> 


输出 : 


I ODUOHH 


ol 


PHP cos() ak 


定义 和 用 法 


cos() 函数 返回 一 个 数 的 余弦 。 


语法 
cos(x) 
参数 
x 必需 。 一 个 数 。 


说 明 


cos() 返回 参数 x 的 余弦 值 。 参 数 x 的 单位 为 弧度 。 


提示 和 注释 


注释 : cos() 返回 的 数值 在 -1 和 1 之 间 。 


例子 
在 本 例 中 ， 我 们 将 计算 不 同 值 的 余弦 : 


<?php 
echo(cos(3)); 
echo(cos( -3)); 
echo(cos(0)); 
echo(cos(M PI)); 
echo(cos(2*M PI)); 
?> 


输出 : 


-0.9899924966004454 
-0.9899924966004454 
1 

cab 

1 


PHP cosh() Ha 


定义 和 用 法 


cosh() 函数 返回 一 个 数 的 双 曲 余弦 。 


语法 
cosh(x) 
参数 
x 必需 。 一 个 数 。 


说 明 


返回 x 的 双 曲 余弦 值 ， 定 义 为 (exp(arg) + exp(-arg))/2. 


例子 
在 本 例 中 ， 我 们 将 返回 不 同 数 的 双 曲 余弦 : 


<?php 

echo(cosh(3); 
echo(cosh( -3); 
echo(cosh(0); 
echo(cosh(M PI); 
echo(cosh(2*M PI)); 
?> 


输出 : 


10.0676619958 
10.0676619958 
1 

11.5919532755 
267.746761484 


PHP decbin() 2X 
定义 和 用 法 

decbin() 函数 把 十 进 制 转换 为 二 进 制 。 
语法 


decbin(dec_number) 


参数 描述 
dec_number 必需 。 规 定 要 转换 的 十 进 制 数 。 


说 明 


返回 一 个 字符 串 ， 包 含有 给 定 dec number 参数 的 二 进 制 表示 。 所 能 转换 的 最 大 数值 为 十 进 
制 的 4294967295， 其 结果 为 32 个 1 的 字符 串 。 


例子 


<?php 

echo decbin("3"); 
echo decbin("1"); 
echo decbin("1587"); 
echo decbin("7"); 

?> 


输出 : 


11 


1 
11000110011 
111 


PHP dechex() 函数 
定义 和 用 法 

dechex() 函数 把 十 进 制 转换 为 十 六 进 制 。 
语法 


dechex(dec_number) 


参数 描述 
dec_number 必需 。 规 定 要 转换 的 十 进 制 数 。 


说 明 


返回 一 个 字符 串 ， 包 含有 给 定 binary string 参数 的 十 六 进 制 表 示 。 所 能 转换 的 最 大 数值 为 十 
进 制 的 4294967295， 其 结果 为 "fffffffr"。 


例子 


<?php 

echo dechex("30"); 
echo dechex("10"), 
echo dechex("1587"); 
echo dechex("70"); 
?> 


输出 : 


1e 


a 
633 
46 


PHP decoct() F2 
定义 和 用 法 

decoct() E3288 T- t fell 1r 35 2 A Ah 
语法 


decoct(dec_number ) 


参数 描述 
dec_number 必需 。 规 定 要 转换 的 十 进 制 数 。 


说 明 


返回 一 个 字符 串 ， 包 含有 给 定 dec number 参数 的 八进制 表示 。 所 能 转换 的 最 大 数值 为 十 进 
制 的 4294967295， 其 结果 为 "37777777777"。 


例子 


<?php 

echo decoct("30"), 
echo decoct("10"), 
echo decoct("1587"); 
echo decoct("70"), 
?> 


输出 : 


36 
12 
3063 
106 


PHP deg2rad() E25 
定义 和 用 法 

deg2rad() 函数 将 角度 转换 为 级 度 。 
语法 


deg2rad(degree_number ) 


参数 描述 
degree number 必需 。 规 定 要 转换 的 角度 。 


说 明 


AEE degree number 从 角度 转换 成 弧度 。 


例子 1 


<?php 

echo deg2rad("30"); 
echo deg2rad("10"); 
echo deg2rad("1587"); 
echo deg2rad("70"); 
?> 


输出 : 


0.523598775598 
0.174532925199 
27.6983752292 
1.2217304764 


例子 2 


<?php 

$deg - 180; 

$rad - deg2rad($deg); 

echo "角度 $deg 等 于 弧度 $rad"; 


?> 


俞 出 : 


角度 180 等 于 弧度 3.14159265359 


PHP exp() aX 


定义 和 用 法 


exp() IA e 的 指数 。 


语法 
exp(x) 
参数 
X 必需 。 一 个 数 。 


说 明 
返回 e 的 x 次 方 值 。。 
提示 和 注释 


提示 A 'e' 作为 自然 对 数 的 底 2.718282。 


例子 


在 本 例 中 ， 我 们 将 对 不 同 的 数 应 用 exp() 函数 : 


<?php 
echo(exp(1)); 
echo(exp( -1)); 
echo(exp(5)); 
echo(exp(10)) 
?> 


输出 : 


2.718281828459045 
©. 36787944117144233 
148.4131591025766 
22026.465794806718 


PHP expm1() 函数 


定义 和 用 法 
expm1() 函数 返回 exp(x) - 1， 甚 至 当 number 的 值 接 近 需 也 能 计算 出 准确 结果 。 
语法 
expmi (x) 
参数 描述 
x 必需 。 一 个 数 。 
说 明 


expm1() 返回 "exp(x) - 1'， 其 至 当 x 的 值 接近 需 也 能 计算 出 准确 结果 。 但 是 当 两 个 数值 趋 近 于 
相等 的 时 候 ， ‘exp (x) - 人 就 会 变 号 不 太 准 确 。 


提示 和 注释 

警告 : 本 画 数 是 实验 性 的 。 本 画 数 的 行为 ， 包 括 画 数 名 称 以 及 其 它 任 何 关 于 本 函数 的 文档 可 
能 会 在 没有 通知 的 情况 下 随 PHP 以 后 的 发 布 而 改变 。 使 用 本 画 数 风险 自 担 。 

提示 : 用 'e' 作为 自然 对 数 的 底 2.718282。 

注释 : AWAKE Windows 平台 下 实现 。 


例子 
在 本 例 中 ， 我 们 将 对 不 同 的 数 应 用 expm1() E : 


<?php 
echo(expm1(1)); 
echo(expm1(-1)); 
echo(expm1(5)); 
echo(expm1(10)) 
?> 


PHP floor() HŽ 


定义 和 用 法 


floor() 函数 向 下 舍 人 为 最 接近 的 整数 。 


语法 
floor(x) 
参数 描述 
x 必需 。 一 个 数 。 


说 明 


返回 不 大 于 x 的 下 一 个 整数 ， 将 x 的 小 数 部 分 舍 去 取 整 。floor() 返回 的 类 型 仍然 是 float, 
为 float 值 的 范围 通常 比 integer BX, 


例子 
在 本 例 中 ， 我 们 籽 对 不 同 的 数 应 用 floor() RA : 


<?php 
echo(floor(0.60)); 
echo(floor(0.40)); 
echo(floor(5)); 
echo(floor(5.1)); 
echo(floor(-5.1)); 
echo(floor(-5.9)) 
?> 


输出 : 


1 0 0 O © 


o 


PHP fmod() 函数 


定义 和 用 法 


fmod() 画 数 返 回 除法 的 浮 点 数 余数 。 


语法 
fmod(x, y) 
参数 描述 
x 必需 。 一 个 数 。 
y 必需 。 一 个 数 。 
说 明 


返回 被 除数 (x) 除 以 除数 (y) 所 得 的 浮 点 数 余数 。 余 数 (r) 的 定义 是 : x=i*y+r， 其 中 ji 
是 整数 。 如 果 y EBA, Nr x 的 符号 相同 并 且 其 数量 值 小 于 y. 

例子 

在 本 例 中 ， 我 们 将 使 用 fmod() HARRE 5/2 的 余数 : 


<?php 

$r = fmod(5,2), 
echo $r 

?> 


输出 : 


1 


PHP hexdec() 函数 
定义 和 用 法 

hexdec() 函数 把 十 六 进 制 转换 为 十 进 制 。 
语法 


hexdec(hex string) 


参数 描述 
hex string 必需 。 规 定 要 转换 的 十 六 进 制 数 。 


说 明 


返回 与 hex string 参数 所 表示 的 十 六 进 制 数 等 值 的 的 十 进 制 数 。hexdec() 将 一 个 十 六 进 制 字 
符 串 转换 为 十 进 制 数 。 所 能 转换 的 最 大 数值 为 7fffffff， 即 十 进 制 的 2147483647。PHP 4.1.0 
开始 ， 该 函数 可 以 处 理 大 数字 ， 这 种 情况 下 ， 它 会 返回 float 类 型 。 


hexdec() 将 遇 到 的 所 有 非 十 六 进 制 字符 替换 成 0。 这 样 ， 所 有 左边 的 需 都 被 忽略 ， 但 右边 的 
aS RT Ar. 


例子 


<?php 

echo hexdec("1e"); 
echo hexdec("a"); 

echo hexdec("11ff"); 
echo hexdec("cceeff"), 
?» 


输出 : 


30 

10 

4607 
13430527 


PHP hypot() 函数 


定义 和 用 法 


hypot() 函数 计算 一 直角 三 角形 的 斜 边 长 度 。 


语法 
hypot(x, y) 
参数 描述 
x 必需 。 边 x 的 长 度 。 
y 必需 。 边 y 的 长 度 。 


说 明 


hypot() 函数 将 会 跟 据 直角 三 角形 的 两 直 解 边 长 度 x 和 y 计算 其 斜 边 的 长 度 。 或 者 是 从 标点 (x 
y) 到 原点 的 距离 。 该 落 数 的 算法 等 同 于 sqrt(xx + yy). 


例子 


<?php 

echo hypot(2,3); 
echo hypot(3,6); 
echo hypot(3,6); 
echo hypot(1,3); 
?> 


输出 : 


3.60555127546 
6. 7082039325 
6. 7082039325 
3.16227766017 


PHP is finite() 函数 
定义 和 用 法 

is finite() HIE S A ARo 
语法 


is finite(x) 


x 必需 。 规 定 要 检查 的 值 。 


说 明 


如 果 x 是 本 机 平台 上 PHP 浮 点 数 所 允许 范围 中 的 一 个 合法 的 有 限 值 ， 则 返回 true, 


例子 


<?php 

echo is_finite(2); 

echo is finite(log(0)); 
echo is finite(2000); 
?> 


输出 : 


PHP is infinite() 函数 
定义 和 用 法 

is infinite() 判断 是 否 为 无 限 值 。 

语法 


is infinite(x) 


x 必需 。 规 定 要 检查 的 值 。 


说 明 


MR x 为 无 穷 大 ( 正 的 或 负 的 ) ， 例 如 log(0) 的 结果 或 者 任何 超出 本 平台 的 浮 点 数 范围 的 
值 ， 则 返回 true. 


例子 


<?php 

echo is infinite(2); 

echo is infinite(log(0)); 
echo is infinite(2000); 
?> 


输出 : 


PHP is nan() 函数 


定义 和 用 法 


is_nan() 判断 是 否 为 合法 数值 。 


语法 
is nan(x) 
参数 描述 
X 必需 。 规 定 要 检查 的 值 。 


说 明 


如 果 x 为 “ 非 数 值 "， 例 如 acos(1.01) 的 结果 ， 


例子 


<?php 

echo is_nan(200); 

echo is_nan(acos(1.01)); 
?> 


则 返回 true. 


PHP Icg value() 2X 
定义 和 用 法 
Icg value() 组 合 线性 同 余 发 生 器 。 
语法 

lcg value() 
说 明 


leg value() 返回 范围 为 (0, 1) 的 一 个 伪 随 机 数 。 本 画 数 组 合 了 周期 为 2*31 - 85 和 2431 - 249 
的 两 个 同 余 发 生 器 。 本 辑 数 的 周期 等 于 这 两 个 素数 的 乘积 。 


例子 


<?php 
echo lcg value(); 
?> 


输出 类 似 : 


0.508212039328 


PHP log() 函数 
定义 和 用 法 

log() 返回 自然 对 数 。 

语法 


log(x,base) 


参数 描述 
X 必需 。 一 个 数 。 
base 可 选 。 如 果 规 定 了 该 参数 ， 则 返回 log<sub>base</sub>x。 


说 明 


如 果 指 定 了 可 选 的 参数 base, log() 返回 log<sub>base</sub>x ， 否 则 log() 返回 参数 x HA 
然 对 数 。 


注释 : 参数 base A PHP 4.3.0 开始 可 用 。 你 可 以 计算 任意 以 b ABN 的 对 数 ， 但 其 实 使 用 
的 是 数学 等 式 : logb(n) = log(n)/log(b), HA log 是 自然 对 数 。 


例子 


<?php 
echo lcg value(); 
?> 


输出 类 似 : 


0.508212039328 


PHP log10() 2K 


定义 和 用 法 


log10() 以 10 为 底 的 对 数 。 


语法 
10g10(x) 
参数 
x 必需 。 一 个 数 。 


说 明 
返回 参数 x 以 10 为 底 的 对 数 。 
提示 和 注释 : 


注释 : 如 果 参 数 x 是 负数 ， 则 返回 -1.#IND。 


例子 


在 本 例 中 ， 我 们 对 不 同 的 数 应 用 log10() BR : 


<?php 
echo(10g10(2.7183)); 
echo(10g10(2)); 
echo(10g10(1)); 
echo(10g10(0)); 
echo(10g10(-1)); 

?> 


输出 类 似 : 


0.434297385125 
0.301029995664 
© 

-1.#INF 
-1.#IND 


PHP log1p() HŽ 


定义 和 用 法 
log1p() 以 返回 log(1 + x), BBY x 的 值 接近 需 也 能 计算 出 准确 结果 。 
语法 
logip(x) 
参数 描述 
x 必需 。 一 个 数 。 
说 明 


警告 本 函数 是 实验 性 的 。 本 男 数 的 行为 ， 包 括 男 数 名 称 以 及 其 它 任何 关于 本 函数 的 文档 可 
能 会 在 没有 通知 的 情况 下 随 PHP MERAMA. ARAB AH, 


PHP max() HŽ 


定义 和 用 法 


max() 返回 最 大 值 。 


语法 
max(x,y) 
参数 描述 
x 必需 。 一 个 数 。 
y 必需 。 一 个 数 。 
说 明 


max() 返回 参数 中 数值 最 大 的 值 。 


如 果 仅 有 一 个 参数 且 为 数组 ，max() 返回 该 数组 中 最 大 的 值 。 如 果 第 一 个 参数 是 整数 、 字 符 串 
或 浮 点 数 ， 则 至 少 需要 两 个 参数 而 max() 会 返回 这 些 值 中 最 大 的 一 个 。 可 以 比较 无 限 多 个 
值 。 


提示 和 注释 


注释 : PHP 会 将 非 数 值 的 字符 串 当 成 0， 但 如 果 这 个 正 是 最 大 的 数值 则 仍然 会 返回 一 个 字符 
串 。 如 果 多 个 参数 都 求 值 为 0 且 是 最 大 值 ，max() 会 返回 其 中 数值 的 0， 如果 参数 中 没有 数值 
的 0， 则 返回 按 字母 表 顺 序 最 大 的 字符 串 。 


例子 
在 本 例 中 ， 我 们 将 使 用 max) 来 返回 两 个 指定 的 数 中 的 最 大 值 


<?php 

echo(max(5,7)); 
echo(max(-3,5)); 
echo(max(-3,-5)); 
echo(max(7.25,7.30)); 
?> 
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输出 类 似 : 


PHP max() ES 


523 


PHP min() E25 


定义 和 用 法 


min() 返回 最 小 值 。 


语法 
min(x,y) 
参数 描述 
x 必需 。 一 个 数 。 
y 必需 。 一 个 数 。 


说 明 
min() 返回 参数 中 数值 最 小 的 。 


如 果 仅 有 一 个 参数 且 为 数组 ，min() 返回 该 数组 中 最 小 的 值 。 如 果 第 一 个 参数 是 整数 、 字 符 串 
或 浮 点 数 ， 则 至 少 需要 两 个 参数 而 min() 会 返回 这 些 值 中 最 小 的 一 个 。 可 以 比较 无 限 多 个 值 。 


提示 和 注释 

注释 : PHP 会 将 非 数 值 的 string 当成 0， 但 如 果 这 个 正 是 最 小 的 数值 则 仍然 会 返回 一 个 字符 
串 。 如 果 多 个 参数 都 求 值 为 0 且 是 最 小 值 ，min() 会 返回 按 字母 表 顺 序 最 小 的 字符 串 ， 如 果 其 
中 没有 字符 串 的 话 ， 则 返回 数值 的 0。 

例子 

在 本 例 中 ， 我 们 将 使 用 min() 来 返回 两 个 指定 的 数 中 的 最 小 值 : 


<?php 

echo(min(5,7)); 
echo(min(-3,5)); 
echo(min(-3,-5)); 
echo(min(7.25,7.30)); 
?> 


ATH A : 
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1 
ow 


7.25 


PHP min() 函数 925 


PHP mt getrandmax() HŽ% 
定义 和 用 法 
mt_getrandmax() 显示 随机 数 的 最 大 可 能 值 。 
语法 
mt getrandmax( ) 
说 明 
返回 调用 mt_rand() 所 能 返回 的 最 大 的 随机 数 。 


例子 


<?php 
echo mt getrandmax(); 
?> 


输出 类 似 : 


3147483649 


PHP mt rand() 函数 


re. : 
mt rand() 使 用 Mersenne Twister 算法 返回 随机 整数 。 
语法 


mt rand(min, max) 


说 明 
如 果 没 有 提供 可 选 参数 min 和 max, mt rand() 返回 0 到 RAND. MAX 之 间 的 伪 随 机 数 。 例 


如 想 要 5 到 15 (包括 5 和 15) 之 间 的 随机 数 ， 用 mt rand(5, 15). 


很 多 老 的 libc 的 随机 数 发 生 器 具有 一 些 不 确定 和 未 知 的 特性 而 且 很 慢 。PHP 的 rand() HER 
认 使 用 libc 随机 数 发 生 器 。mt_rand() 画 数 是 非 正 式 用 来 替换 它 的。 该 图 数 用 了 Mersenne 
Twister 中 已 知 的 特性 作为 随机 数 发 生 器 ， 它 可 以 产生 随机 数值 的 平均 速度 比 libe 提供 的 
rand() 快 四 倍 。 


提示 和 注释 

注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() 函数 给 随机 数 发 生 器 播种 ， 现 在 
已 自动 完成 。 

注释 : 在 3.0.7 之 前 的 版 本 中 ，max 的 含义 是 range 。 要 在 这 些 版 本 中 得 到 和 上 例 相 同 5 到 


15 的 随机 数 ， 简 短 的 例子 是 mt rand (5, 11)。 


例子 
在 本 例 中 ， 我 们 会 返回 一 些 随机 数 : 


<?php 

echo(mt rand()); 
echo(mt rand()); 
echo(mt rand(10,100)), 
?> 


输出 类 似 : 
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3150906288 
513289678 
35 


PHP mt rand() aX 920 


PHP mt srand() 2 
定义 和 用 法 

mt srand() 播种 Mersenne Twister 随机 数 生 成 器 。 
语法 


mt srand(seed) 


参数 描述 
seed 必需 。 用 seed 来 给 随机 数 发 生 器 播种 。 
说 明 


从 PHP 4.2.0 版 开始 ，seed 参数 变 为 可 选项 ， 当 该 项 为 空 时 ， 会 被 设 为 随时 数 。 


提示 和 注释 

注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() BAŠTA BELL ERE, mo 
自动 完成 。 

例子 

在 本 例 中 ， 我 们 将 播种 随机 数 生 成 器 : 


<?php 

mt srand(mktime()); 
echo(mt rand()); 

?> 


输出 类 似 : 


1132656473 


PHP octdec() šk 
定义 和 用 法 

octdec() 画 数 把 八进制 转换 为 十 进 制 。 
语法 


octdec(octal string) 


参数 描述 
octal_string 必需 。 规 定 要 转换 的 八进制 数 。 


说 明 


返回 octal string 参数 所 表示 的 八进制 数 的 十 进 制 等 值 。 可 转换 的 最 大 的 数值 为 
17777777777 或 十 进 制 的 2147483647。 从 PHP 4.1.0 开始 ， 该 范 数 可 以 处 理 大 数字 ， 这 种 


情况 下 ， 它 会 返回 float 类 型 。 


例子 


<?php 

echo octdec("36"), 
echo octdec("12"), 
echo octdec("3063"); 
echo octdec("106"); 
?> 


输出 类 似 : 


30 
10 
1587 
70 


PHP pi() 2X 
定义 和 用 法 
pi() E23 [B] A fe] E BA] f 
语法 

pi() 


说 明 


返回 圆周 率 的 近似 值 。 返 回 值 的 float 精度 是 由 php.ini 中 的 precision 指令 确定 。 默 认 值 是 
14。 您 也 可 以 使 用 M_PI 常量 ， 该 常量 产生 与 pi() 完全 相同 的 结果 。 


例子 


<?php 
echo pi(); 
?> 


输出 类 似 : 


3.14159265359 


PHP pow() HŽ% 


定义 和 用 法 


pow() BABIE] x 的 y 次 方 。 


语法 
pow(x, y) 
参数 描述 
X 必需 。 一 个 数 。 
y 必需 。 一 个 数 。 


说 明 
返回 x 的 y RHR. MRA, SRNA RE integer. 


如 果 不 能 计算 早 ， 将 发 出 一 条 警告 ，pow() 将 返回 false, PHP 4.2.0 版 开始 pow) 不 要 产生 
任何 的 警告 。 


例子 


<?php 

echo pow(4,2); 
echo pow(6,2), 
echo pow(-6,2); 
echo pow( -6, -2); 
echo pow(-6,5.5); 
?> 


输出 类 似 : 


16 

36 

36 
0.0277777777778 
-1.#IND 


PHP rad2deg() E325 
定义 和 用 法 

rad2deg() HAMM >A BER, 
语法 


rad2deg(radian number) 


参数 描述 
radian number 必需 。 规 定 要 转换 的 弧度 。 


说 明 


ARABUS radian number 从 弧度 转换 为 角度 。 


例子 


<?php 

$rad = M PI, 

$deg = rad2deg($rad); 

echo "$rad radians is equal to $deg degrees"; 
?> 


输出 类 似 : 


3.14159265359 radians is egual to 180 degrees 


PHP rand() 2X 


定义 和 用 法 
rand() 函数 返回 随机 整数 。 
语法 


rand(min, max) 


BR 描述 
min,max 可 选 。 规 定 随机 数 产生 的 范围 。 


说 明 


如 果 没 有 提供 可 选 参数 min 和 max, rand() 返回 0 到 RAND. MAX 之 间 的 伪 随 机 整数 。 例 
如 ， 想 要 5 到 15 (包括 5 和 15) 之 间 的 随机 数 ， 用 rand(5, 15). 


提示 和 注释 


注释 : 在 某 些 平台 下 (例如 Windows) RAND MAX 只 有 32768。 如 果 需 要 的 范围 大 于 
32768， 那 么 指定 min 和 max 参数 就 可 以 生成 大 于 RAND_MAX 的 数 了 ， 或 者 考虑 用 
mt rand() 来 替代 它 。 


注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() 函数 给 随机 数 发 生 器 播种 ， 现 在 
已 自动 完成 。 


注释 : 在 3.0.7 之 前 的 版 本 中 ，max 的 含义 是 range 。 要 在 这 些 版 本 中 得 到 和 上 例 相同 5 到 
15 的 随机 数 ， 简 短 的 例子 是 rand (5, 11). 


例子 


本 例会 返回 一 些 随 机 数 : 


<?php 

echo(rand(); 
echo(rand(); 
echo(rand(10, 100) ) 
?> 
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输出 : 


17757 
3794 
97 


PHP rand() 函数 


535 


PHP round() 2% 
定义 和 用 法 

round() E25 3175 a 28 9E TT PU Rs 
语法 


round(x, prec) 


参数 描述 
x 可 选 。 规 定 要 舍 入 的 数字 。 
prec 可 选 。 规 定 小 数 点 后 的 位 数 。 
说 明 


返回 将 x 根据 指定 精度 prec (十 进 制 小 数 点 后 数字 的 数目 ) 进行 四 舍 五 入 的 结果 。prec 也 可 
以 是 负数 或 需 (默认 值 ) 。 


提示 和 注释 
注释 : PHP 默认 不 能 正确 处 理 类 似 "12,300.2" 的 字符 串 。 


注释 : prec 参数 是 在 PHP 4 中 被 引入 的 。。 


例子 


<?php 
echo(round(0.60)); 
echo(round(0.50)); 
echo(round(0.49)); 
echo(round(-4.40)); 
echo(round(-4.60)); 
?> 


输出 : 
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H 


1 
ol 


PHP round() 函数 537 


PHP sin() Až 


定义 和 用 法 


sin() 函数 返回 一 个 数 的 正弦 。 


语法 
sin(x) 
参数 
X 必需 。 一 个 数 。 


说 明 


sin() 返回 参数 x 的 正弦 值 。 参 数 x 的 单位 为 弧度 。 


提示 和 注释 


注释 : sin() KAUR EZAN F -1 和 1 之 间 。 


例子 
在 本 例 中 ， 我 们 将 计算 不 同 值 的 正弦 : 


<?php 
echo(sin(3)); 
echo(sin(-3)); 
echo(sin(@)); 
echo(sin(M PI)); 
echo(sin(M PI 2)) 
?> 


输出 : 


0.14112000806 
-0.14112000806 

© 
1.22460635382E -016 
1 


PHP sinh() Ha 


定义 和 用 法 


sinh() 函数 返回 一 个 数 的 双 曲 正弦 。 


语法 
sinh(x) 
参数 
x 必需 。 一 个 数字 。 


说 明 


返回 x 的 双 曲 正弦 值 ， 定 义 为 (exp(arg) - exp(-arg))/2。 


例子 
在 本 例 中 ， 我 们 将 返回 不 同 数 的 双 曲 正弦 : 


<?php 
echo(sinh(3)); 
echo(sinh(-3)); 
echo(sinh(0)); 
echo(sinh(M PI)); 
echo(sinh(M PI 2)); 
?» 


输出 : 


10.0178749274 
-10.0178749274 
© 

11.5487393573 
2. 39129890231 


PHP sqrt() 2X 


定义 和 用 法 


sqrt() 函数 返回 一 个 数 的 平方 根 。 


语法 
sgrt(x) 
参数 
x 必需 。 一 个 数字 。 
说 明 
返回 x 的 平方 根 。 


提示 和 注释 


注释 : 如 果 参 数 x 是 负数 ， 则 sart) 函数 返回 -1.#IND. 


例子 
在 本 例 中 ， 我 们 将 返回 不 同 数 的 平方 根 : 


<?php 
echo(sqrt(0)); 
echo(sqrt(1)); 
echo(sqrt(9)); 
echo(sqrt(0.64)); 
echo(sqrt(-9)); 
?> 


PHP srand() 函数 
定义 和 用 法 

srand() 函数 播 下 随机 数 发 生 器 种 子 。 
语法 


srand(seed) 


参数 描述 
seed 可 选 。 用 seed 播 下 随机 数 发 生 器 种 子 。 
说 明 


从 PHP 4.2.0 版 开始 ，seed 参数 变 为 可 选项 ， 当 该 项 为 空 时 ， 会 被 设 为 随时 数 。 


提示 和 注释 


注释 : A PHP 4.2.0 起 ， 不 再 需要 用 srand() 或 mt srand() 函数 给 随机 数 发 生 器 播种 ， 现 在 
已 自动 完成 。 


例子 
在 本 例 中 ， 我 们 将 播种 随机 数 发 生 器 : 


<?php 
srand(mktime()); 
echo(rand()); 

?> 


输出 : 


23054 


PHP tan() E325 


定义 和 用 法 


tan() FAŠURIE] EV]. 


语法 
tan(x) 
参数 
x 必需 。 一 个 数 。 


说 明 


tan() 返回 参数 x 的 正切 值 。 参 数 x 的 单位 为 弧度 


例子 
在 本 例 中 ， 我 们 将 返回 不 同 的 数 的 正切 : 


<?php 
echo(tan(M PI 4)); 
echo(tan(0.50)); 
echo(tan(-0.50)); 
echo(tan(5)); 
echo(tan(10)); 
echo(tan( -5)); 
echo(tan( -10)); 

?> 


俞 出 : 


1 

©. 546302489844 
-0.546302489844 
-3.38051500625 
0.648360827459 
3.38051500625 
-0.648360827459 


PHP tanh() HŽ 


定义 和 用 法 


tanh() ESOS XX EB IE. 


语法 
tanh(x) 
参数 
x 必需 。 一 个 数 。 


说 明 


返回 x 的 双 曲 正切 值 ， 定 义 为 sinh(arg)/cosh(arg)。 


例子 
在 本 例 中 ， 我 们 将 返 回 不 同 的 数 的 双 曲 正切 : 


<?php 
echo(tanh(M PI 4)), 
echo(tanh(0.50)); 
echo(tanh(-0.50)); 
echo(tanh(5)); 
echo(tanh(10)); 
echo(tanh( -5)); 
echo(tanh( -10)) 

?> 


俞 出 : 


0.655794202633 
0.46211715726 
-0.46211715726 
0.999909204263 
0.999999995878 
-0.999909204263 
-0.999999995878 


PHP 5 MySQLi 函数 


PHP MySQLi 简介 


PHP MySQLi = PHP MySQL Improved! 
MySQLi 函数 允许 您 访问 MySQL 数据 库 服 务 器 。 
注释 : MySQLi 扩展 被 设计 用 于 MySQL 4.1.13 版 本 或 更 新 的 版 本 。 


安装 / Runtime 配置 


为 了 能 够 顺利 使 用 MySQLi 函数 ， 您 必须 在 编译 PHP 时 添加 对 MySQLi 扩展 的 支持 。 
MySQLi 扩展 是 在 PHP 5.0.0 版 本 中 引进 的 。MySQL Native Driver 包含 在 PHP 5.3.0 版 本 。 
有 关 安 装 的 详细 信息 ， 请 访问 : http:/www.php.net/manual/en/mysqli.installation.php 


有 关 运 行 配置 的 详细 信息 ， 请 访问 : http//www.php.net/manual/en/mysqli.configuration.php 


PHP 5 MySQLi 函数 


函数 描述 
mysgli affected rows() 返回 前 一 次 MySQL 操作 所 影响 的 记录 行 数 。 
mysgli autocommit() 打开 或 关闭 自动 提交 数据 库 修改 。 
mysqli_change_user() 更 改 指定 数据 库 连 接 的 用 户 。 
mysgli character set name() 返回 数据 库 连 接 的 默认 字符 集 。 
mysgli close() 关闭 先前 打开 的 数据 库 连 接 。 
mysgli commit() 提交 当前 事务 。 
mysgli connect errno() 返回 上 一 次 连接 错误 的 错误 代码 。 
mysqli connect error() 返回 上 一 次 连接 错误 的 错误 描述 。 
mysqli_connect() 打开 一 个 到 MySQL 服务 器 的 新 的 连接 。 
mysgli data seek() 调整 结果 指针 到 结果 集中 的 一 个 任意 行 。 
mysgli debug() 执行 调试 操作 。 
mysqli dump debug info() 转 储 调试 信息 到 日 志 


mysqli_errno() RE 35: 33 FH ERE — RA . 
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mysgli error list() 


mysqli_error() 


mysqli_fetch_all() 


mysqli_fetch_array() 
mysqli_fetch_assoc() 
mysqli_fetch_field_direct() 


mysqli_fetch_field() 
mysqli_fetch_fields() 
mysqli_fetch_lengths() 
mysali fetch object() 

mysgli fetch row() 

mysgli field count() 
mysagli field seek() 

mysgli field tell() 
mysali free result() 
mysali get charset() 
mysgli get client info() 
mysgli get client stats() 
mysgli get client version() 
mysgli get connection stats() 
mysgli get host info() 
mysgli get proto info() 
mysgli get server info() 
mysgli get server version() 


mysali info() 
mysqli_init() 


mysqli_insert_id() 
mysql kill() 


mysgli more results() 


PHP 5 MySQLi 函数 


i [B] Sco 33 FA BY 4H 1k UFR 
i [B RIT NRT 48 ik TRU 
从 结果 集 


中 取得 所 有 行 作 为 关联 数组 ， 或 数字 数组 ， 


或 二 者 兼 有 。 

从 结果 集中 取得 一 行 作为 关联 数组 ， 或 数字 数组 ， 或 
二 者 兼 有 。 

从 结果 集中 取得 一 行 作为 关联 数组 。 


从 结果 集中 取得 某 个 单一 字段 的 meta-data， 并 作为 


对 象 返 回 。 
从 结果 集中 取得 下 一 字段 ， 并 作为 对 象 返 
返回 结果 中 代表 字段 的 对 象 的 数组 。 
回 结果 集中 当前 行 的 每 个 列 的 长 度 。 
果 集 中 取得 当前 行 ， 并 作为 对 象 返回 
从 结果 集中 取得 一 行 ， 并 作为 枚 举 数组 返回 
返回 最 近 查 询 的 列 数 。 
把 结果 集中 的 指针 设置 为 指定 
回 结果 集中 的 指针 的 位 置 。 
释放 结果 内 存 。 
返回 字符 集 对 象 。 
返回 MySQL 客户 端 库 版 本 。 
返回 有 关 客 户 端 每 个 进程 的 统计 。 
将 MySQL 客户 端 库 版 本 作为 整数 返回 。 
返回 有 关 客 户 端 连接 的 统计 。 
返回 MySQL 服务 器 主机 名 和 连接 类 型 。 
返回 MySQL 协议 版 本 。 
返回 MySQL 服务 器 版 本 。 
将 MySQL 服务 器 版 本 作为 整数 返回 。 
返回 有 关 最 近 执 行 查询 的 信息 。 


字段 的 偏 移 量 。 


[žil 


初始 化 MySQLi 并 返回 mysgli real connect() 使 用 


的 资源 。 

返回 最 后 一 个 查询 中 自动 生成 的 ID。 
请 求 服务 器 杀 死 一 个 MySQL 线程 。 
检查 一 个 多 查询 是 否 有 更 多 的 结 
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mysqli multi query() 
mysgli next result() 
mysgli num fields() 
mysqli num rows() 


mysgli options() 
mysqli_ping() 


mysqli_prepare() 
mysqli_query() 
mysqli_real_connect() 
mysqli_real_escape_string() 
mysqli_real_query() 
mysqli_reap_async_query() 
mysqli_refresh() 

mysali rollback() 

mysgli select db() 
mysqli set charset() 


mysgli set local infile default() 


mysgli set local infile handler() 


mysgli sglstate() 


mysgli ssl set() 


mysqli_stat() 
mysqli_stmt_init() 


mysali store result() 
mysgli thread id() 
mysgli thread safe() 


mysqli use result() 


mysgli warning count() 


执行 一 个 或 多 个 针对 数据 库 的 查询 。 

为 mysqli_multi guery() 准备 下 一 个 结果 集 。 

返回 结果 集中 字段 的 数量 。 

返回 结果 集中 行 的 数量 。 

设置 额外 的 连接 选项 ， 用 于 影响 连接 行为 。 
AE UNIUS 


准 各 执行 一 个 SQL 语句 。 

执行 某 个 针对 数据 库 的 查询 。 

打开 一 个 到 MySQL 服务 器 的 新 的 链接 。 

转 义 在 SQL 语句 中 使 用 的 字符 串 中 的 特殊 字符 。 
执行 SQL 查询 


返回 异步 查询 的 结果 。 

刷新 表 或 缓存 ， 或 者 重 置 复制 服务 器 信息 。 
回 滚 数据 库 中 的 当前 事务 。 

更 改 连接 的 默认 数据 库 。 


设置 默认 客户 端 字符 集 。 

撤销 用 于 load local infile RSHA > A ELAH. 
设置 用 于 LOAD DATA LOCAL INFILE ASHEA ER 
数 


o 


返回 最 后 一 个 MySQL 操作 的 SQLSTATE 错误 代 
码 。 


用 于 创建 SSL 安全 连接 。 
返回 当前 系统 状态 。 
初始 化 声明 并 返回 mysqli_stmt_prepare() 使 用 的 对 


传输 最 后 一 个 查询 的 结果 集 。 
返回 当前 连接 的 线程 ID 
返回 是 否 将 客 户 端 库 编 译 成 thread-safe. 


从 上 次 使 用 mysqli real query() 执行 的 查询 中 初始 
化 结果 集 的 检索 。 


返回 连接 中 的 最 后 一 个 查询 的 警告 数量 。 


BA 
940 


PHP mysqli affected rows() Až 


实例 
从 不 同 的 查询 中 输出 所 影响 记录 行 数 : 


<?php 
$conzmysgli connect("localhost", "my user", "my password", "my db"); 
if (mysgli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


J 


// Perform queries and print out affected rows 
mysqli guery($con, "SELECT * FROM Persons"); 
echo "Affected rows: " . mysqli affected rows($con), 


mysqli guery($con, "DELETE FROM Persons WHERE Age>32"), 
echo "Affected rows: " . mysqli affected rows($con), 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli affected rows() 函数 返回 前 一 次 MySQL 操作 (SELECT, INSERT, UPDATE, 
REPLACE, DELETE) 所 影响 的 记录 行 数 。 


mysgqliaffected rows( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


一 个 > 0 的 整数 表示 所 影响 的 记录 行 数 。0 表示 没有 受 影响 的 记录 。-1 表示 
查询 返回 错误 。 


PHP mysgli autocommit() E32X 


实例 
关闭 自动 提交 ， 做 一 些 坦 询 ， 然 后 提交 查询 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Set autocommit to off 

mysqli_autocommit($con, FALSE), 

// Insert some values 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Peter','Griffin',35)"); 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Glenn','Quagmire',33)"); 


// Commit transaction 
mysqli_commit($con); 


// Close connection 
mysqli_close($con); 
?> 


定义 和 用 法 
mysqli_autocommit() HAF ERK B] A abite 52 Be EM. 


tem : 请 查看 mysql commit() 函数 ， 用 于 提交 指定 数据 库 连 接 的 当前 事务 。 请 查看 
mysqli_rollback() 画 数 ， 用 于 回 滚 当 前 事务 。 


语法 
mysqliautocommit(_connection,mode); 


参数 描述 
connection ”必需 。 规 定 要 使 用 的 MySQL 连接 。 


必需 。 如 果 设 置 为 FALSE， 则 表示 关闭 auto-commit。 如 果 设 置 为 


mode TRUE, WIRTH auto-commit (18zz £4 45 EH) ， 


技术 细节 


返回 值 : 如 果 成 功 则 返回 TRUE, MRAM FALSE. 
PHP 版 本 : 5+ 


PHP mysgli change user() 2% 


实例 
改变 指定 数据 库 连接 的 用 户 : 


<?php 
$conzmysgli connect("localhost", "my user", "my password", "my db"); 


// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 

} 

// Reset all and select a new database 
mysqli_change_user($link, "my_user", "my_password", "my_test"); 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_change_user() 本 数 改变 指定 数据 库 连 接 的 用 户 ， 并 设置 当前 数据 库 。 


mysqlichange_user(_connection, username, password, dbname); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
username 必需 。 规 定 MySQL 用 户 名 。 
password 必需 。 规 定 MySQL 密码 。 
dbname 必需 。 规 定 要 改变 的 新 数据 库 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysgli character set name() Až 


实例 
返回 数据 亩 连接 的 默认 字符 集 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 
} 

$charset-mysgli character set name($con), 

echo "Default character set is: " . $charset, 


mysqli close($con), 
?> 


定义 和 用 法 


mysgli character set name() 函数 返回 数据 库 连 接 的 默认 字符 集 。 


mysqlicharacte set name( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 指定 连接 的 默认 字符 集 。 
PHP 版 本 : 5+ 


PHP mysali close() E325 


实例 
关闭 先前 打开 的 数据 库 连 接 : 


<?php 
$conzmysgli connect("localhost", "my user", "my password", "my db"); 


// ....some PHP code... 


m Sg EEE CoU 
中 、 3 
mysdli close() BAŠTA 0 2c BU $T AH BE i k. 


语法 


mysgqliclose( connection); 


参数 描述 
connection 必需 。 规 定 要 关闭 的 MySQL 连接 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysqli_commit() 函数 


实例 
关闭 自动 提交 ， 做 一 些 坦 询 ， 然 后 提交 查询 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Set autocommit to off 
mysqli_autocommit($con, FALSE), 


// Insert some values 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Peter','Griffin',35)"); 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Glenn','Quagmire',33)"); 


// Commit transaction 
mysqli_commit($con); 


// Close connection 


mysqli_close($con); 
?> 


定义 和 用 法 
mysqli commit() 函数 提交 指定 数据 库 连 接 的 当前 事务 。 


tem : 请 查看 mysqli_autocommit() 函数 ， 用 于 开启 或 关闭 自动 提交 数据 库 修改 。 请 查看 


mysqli_rollback() 画 数 ， 用 于 回 滚 当 前 事务 。 


ak 
[o 


语法 


mysqlicommit( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysqli_commit() 函数 554 


PHP mysgli connect errno() HŽ% 


例 


返回 上 一 次 连接 错误 的 错误 代码 : 


将 


<?php 

$conzmysgli connect("localhost", "wrong user", "my password", "my db"); 
// Check connection 

if (!$con) 

{ 


die("Connection error: " . mysqli_connect_errno(); 


?> 


r3. N 

mysgli connect errno() EUR EI E — IR iE EAE RRNA. 
语法 

mysqliconnect errno(): 

技术 细节 


返回 值 : 返回 错误 代码 值 ， 如 果 没 有 错误 发 生 则 返回 0。 
PHP 版 本 : 5+ 


PHP mysgli connect error() Až 


实例 
返回 上 一 次 连接 错误 的 错误 描述 : 


<?php 

$conzmysgli connect("localhost", "wrong user", "my password", "my db"); 
// Check connection 

if (!$con) 


die( "Connection error: " . mysgli connect error(); 


} 


?> 


定义 和 用 法 


mysqli_connect_error() 本 数 返回 上 一 次 连接 错误 的 错误 描述 。 


mysqliconnect error(); 


技术 细节 


返回 值 : 返回 一 个 描述 错误 的 字符 串 。 如 果 没 有 错误 发 生 则 返回 NULL. 
PHP 版 本 : 5+ 


PHP mysgqli connect() 2X 


实例 
打开 一 个 到 MySQL 服务 器 的 新 的 连接 : 
<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"); 


// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


定义 和 用 法 
mysqli_connect() 函数 打开 一 个 到 MySQL 服务 器 的 新 的 连接 。 


语法 


mysqliconnect(_host,username, password, dbname, port, socket); 





BR 描述 
host 可 选 。 规 定 主机 名 或 IP 地 址 。 
username 可 选 。 规 定 MySQL HP A. 
password 可 选 。 规 定 MySQL 密码 。 
dbname 可 选 。 规 定 默认 使 用 的 数据 库 。 
port 可 选 。 规 定 党 试 连接 到 MYSOL 服务 器 的 端口 号 。 
socket 可 选 。 规 定 socket 或 要 使 用 的 已 命名 pipe. 
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返回 值 : 返回 一 个 代表 到 MySQL 服务 器 的 连接 的 对 象 。 
PHP 版 本 : 5+ 


PHP mysgli data seek() 函数 


实例 
在 结果 集中 寻找 行 号 15 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
$sql="SELECT Lastname,Age FROM Persons ORDER BY Lastname"; 
if ($result=mysqli_query($con, $sql) ) 


// Seek to row number 15 
mysqli_data_seek($result,14); 


// Fetch row 
$row=mysqli_fetch_row($result); 


printf ("Lastname: %s Age: %sn", $row[0], $row[1]); 
// Free result set 


mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


= . N 
mysqli_data_seek() 函数 调整 结果 指针 到 结果 集中 的 一 个 任意 行 。 


语法 


mysqlidata seek( result offset), 


参数 描述 
T 必需 。 规 定 由 mysqli guery(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 


offset VE. WEFR. AVE O 0 和 行 总 数 -1 之 间 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysgli data seek() MŽ% 959 


PHP mysqli_debug() 2% 


实例 
在 本 地 机 上 的 "/temp/client.trace" 中 创建 一 个 trace 文件 : 


<?php 
mysgli debug("d:t:o,/temp/client.trace"); 
?» 


定义 和 用 法 
mysqli_debug() 函数 用 于 执行 调试 操作 。 


注释 : 为 了 使 用 该 娘 数 ， 您 必须 编译 MySQL 客户 端 库 来 支持 调试 。 


语法 


mysqlidebug( message), 


参数 描述 
message 必需 。 一 个 代表 要 执行 的 调试 操作 的 字符 串 。 


7X A im $ 


返回 值 : 
PHP 版 本 : 5+ 


TRUE 


PHP mysqli dump debug info() 函数 


实例 
转 储 调试 信息 到 日 志 


<?php 
mysgli dump debug info($con); 
?> 


= ~ N 

mysqli dump debug info() 函数 转 储 调试 信息 到 日 志 中 。 
语法 

mysqlidump debug info( link); 


BB 描述 
link 必需 。 一 个 由 mysqli connect() & mysgli init() 返回 的 连接 标识 符 。 


技术 细节 


返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysali errno() E325 


实例 
返回 最 近 调用 丁 数 的 最 后 一 个 错误 代码 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 

t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


J 


// Perform a query, check for error 
if (!mysqli guery($con, "INSERT INTO Persons (FirstName) VALUES ('Glenn')")) 


echo("Errorcode: " . mysgli errno($con)), 
} 

mysqli_close($con) ; 

?» 


ch 、 : 
mysqli_errno() 画 数 返 回 最 近 调 用 函数 的 最 后 一 个 错误 代码 。 
语法 


mysqlierrno(_connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 返回 错误 代码 值 。 如 果 没 有 错误 发 生 则 返回 0。 
PHP 版 本 : 5+ 


PHP mysali error list() HŽ% 


实例 
返回 最 近 调 用 图 数 的 错误 列表 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


J 


// Perform a query, check for error 
if (!mysqli query($con,"INSERT INTO Persons (FirstName) VALUES ('Glenn')")) 


print r(mysqli error list($con)), 


mysqli close($con), 
?> 


定义 和 用 法 
mysgli error list() 函数 返回 最 近 调 用 画 数 的 错误 列表 。 


BiB 


mysqlierror_list(_connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 回 错误 列表 。 每 个 错误 都 是 一 个 带 有 errno (错误 代码 ) error (错误 文 
值 : 本 ) 和 sqlstate 的 关联 数组 。 


PHP mysali error() EK 


apr 
实例 
返回 最 近 调 用 函数 的 最 后 一 个 错误 描述 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 

t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


J 


// Perform a query, check for error 
if (!mysqli guery($con, "INSERT INTO Persons (FirstName) VALUES ('Glenn')")) 


echo( "Error description: " . mysgli error($con)); 
J 

mysqli close($con), 

?> 


= 、 N 
mysgli error() HGR [p] 835-3] FB ES CB] c e — P 46 kta, 
语法 


mysglierror( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 返回 一 个 带 有 错误 描述 的 字符 串 。 如 果 没 有 错误 发 生 则 返回 ""。 
PHP 版 本 : 5+ 


PHP mysagli fetch all() 函数 


实例 
从 结果 集中 取得 所 有 行 作为 关联 数组 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
$result=mysqli_query($con, $sql); 


// Fetch all 
mysqli fetch all($result,MYSQLI ASSOC); 


// Free result set 
mysqli free result($result), 


mysqli close($con), 
?> 


定义 和 用 法 
mysqli_fetch_all() 函数 从 结果 集中 取得 所 有 行 作为 关联 数组 ， 或 数字 数组 ， 或 二 者 兼 有 。 


注释 : ARARE # A MySQL Native Driver 时 可 用 。 
语法 


mysqlifetch_all(_result,resulttype); 


参数 描述 


必需 。 规 定 由 mysqli_query()、mysqli_store_result() 或 


uid mysgli use result() 返回 的 结果 集 标 识 符 。 
resulttype ”可 选 。 规 定 应 该 产生 哪 种 类 型 的 数组 。 可 以 是 以 下 值 中 的 一 个 : 


MYSQLI ASSOC  MYSQLI NUM  MYSQLI BOTH 


技术 细节 
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返回 值 : 返回 包含 结果 行 的 关联 数组 或 数字 数组 。 
PHP 版 本 : 5.3+ 


PHP mysali_fetch_all() 函数 966 


PHP mysali fetch array() 2% 


实例 
从 结果 集中 取得 一 行 作为 数字 数组 或 关联 数组 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
$result=mysqli_query($con, $sql) 


// Numeric array 
$row=mysqli_fetch_array($result,MYSQLI_NUM); 
printf ("%s (%s)n",$row[0],$row[1]); 

// Associative array 
$row=mysqli_fetch_array($result,MYSQLI_ASSOC) ; 
printf ("%s (%s)n",$row["Lastname"], $row["Age"]); 


// Free result set 
mysqli_free_result($result); 


mysqli_close($con); 
?> 


ch. S 
mysgli fetch array() 函数 从 结果 集中 取得 一 行 作 为 关联 数组 ， 或 数字 数组 ， 或 二 者 兼 有 。 


注释 : 该 图 数 返回 的 字段 名 是 区 分 大 小 写 的 。 


语法 


mysgqlifetch array( result,resulttype); 


参数 描述 
result 必需 。 规 定 由 mysqli_query()、mysqli_store_result() 或 
mysqli_use_result() 返回 的 结果 集 标识 符 。 
i ERSA D 米 BE JE pA 
resulttype ”可 选 。 规 定 应 该 产生 哪 种 类 型 的 数组 。 可 以 是 以 下 值 中 的 一 个 : 


MYSOLI ASSOC  MYSQLI NUM  MYSQLI BOTH 


返回 与 读 取 行 匹配 的 字符 串 数组 。 如 果 结 果 集 中 没有 更 多 的 行 则 返回 
NULL。 


PHP mysqli fetch assoc() Ea 


实例 
从 结果 集中 取得 一 行 作为 关联 数组 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
$result=mysqli_query($con, $sql) 


// Associative array 
$row=mysqli_fetch_assoc($result); 
printf ("%s (%s)n",$row["Lastname"],$row["Age"]); 


// Free result set 
mysqli_free_result($result); 


mysqli_close($con); 
?> 


= 、 : 
mysqli_fetch_array() 函数 从 结果 集中 取得 一 行 作为 关联 数组 。 


注释 : 该 贺 数 返回 的 字段 名 是 区 分 大 小 写 的 。 
语法 


mysgqlifetch assoc( result); 


参数 描述 


TT 必需 。 规 定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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W3School PHP 参考 手册 


返回 值 : 返回 代表 读 取 行 的 关联 数组 。 如 果 结 果 集 中 没有 更 多 的 行 则 返回 NULL. 
PHP 版 本 : 5+ 


PHP mysgqli fetch assoc() HX 970 


PHP mysqli fetch field direct() HŽ% 


实例 
返回 结果 集中 某 个 单一 字段 ( 列 ) 的 meta-data， 并 输出 字段 名 称 、 表 格 和 最 大 长 度 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 


// Get field information for "Age" 
$fieldinfozmysgli fetch field direct($result,1), 


printf("Name: %sn",$fieldinfo->name) ; 
printf("Table: %sn",$fieldinfo->table); 
printf("max. Len: %dn",$fieldinfo->max_length) ; 


// Free result set 


mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


= 、 3 

mysgli fetch field direct() 函数 从 结果 集中 取得 某 个 单一 字段 〈 列 ) 的 meta-data, FEA xt 
象 返回 。 

语法 

mysglifetch field direct( result,fieldnr); 


参数 描述 


result | Ži. 规定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 


fieldnr ”必需 。 规 定 字段 号 。 必 须 介 于 0 和 字段 数 -1 之 间 。 
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返回 包含 字段 定义 信息 的 对 象 。 如 果 没 有 可 用 信息 则 返回 FALSE. ik 351 Rf TF 
列 属性 : name - 列 名 orgname - 原始 的 列 名 (如果 指定 了 别名 ) table -RE 
orgtable - 原始 的 表 名 〈 如 果 指 定 了 别名 ) def - 该 字段 的 默认 值 
max length - 字段 的 最 大 宽度 length - 在 表 定 义 中 规定 的 字段 宽度 charsetnr 
- 字段 的 字符 集 号 flags - 字段 的 位 标志 type - 用 于 字段 的 数据 类 型 
decimals - 整数 字段 ， 小 数 点 后 的 位 数 


5+ 


PHP mysali fetch field() 函数 


实例 
返回 结果 集中 下 一 字段 ( 列 ) ， 然 后 输出 每 个 字段 名 称 、 表 格 和 最 大 长 度 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli guery($con, $sg1)) 


{ 
// Get field information for all fields 
while ($fieldinfo=mysqli_fetch_field($result) ) 


printf("Name: %sn",$fieldinfo->name) ; 
printf("Table: %sn",$fieldinfo->table); 
printf("max. Len: %dn",$fieldinfo->max_length) ; 


// Free result set 


mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


= . 3 

mysgli fetch field() HAM 25 RE RR RFR (9) ， 并 作为 对 象 返回 。 
语法 

mysalifetch field( result); 


参数 描述 


T 必需 。 规 定 由 mysqli query(). mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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返回 包含 字段 定义 信息 的 对 象 。 如 果 没 有 可 用 信息 则 返回 FALSE。 该 对 象 有 下 
列 属性 : name - 列 名 orgname -原始 的 列 名 (如 果 指 定 了 别名 ) table - 表 名 
orgtable - 原始 的 表 名 (如 果 指 定 了 别名 ) def -保留 作为 默认 值 ， 当 前 总 是 
为 "" db -数据 库 (在 PHP 5.3.6 中 新 增 的 ) catalog -目录 名 称 ， 总 是 为 
"def" (A PHP 5.3.6 #2) max length - 字段 的 最 大 宽度 length -在 表 定 义 中 
规定 的 字段 宽度 charsetnr - 字段 的 字符 集 号 flags - 字段 的 位 标志 type -用 
于 字段 的 数据 类 型 decimals - 整数 字段 ， 小 数 点 后 的 位 数 


PHP mysgqli fetch fields() E325 


实例 
返回 结果 集中 代表 字段 ( 列 ) 的 对 象 的 数组 ， 然 后 输出 每 个 字段 名 称 、 表 格 和 最 大 长 度 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 


{ 
// Get field information for all fields 
$fieldinfo=mysqli_fetch_fields($result); 


foreach ($fieldinfo as $val) 
printf ( "Name: %sn", $val->name), 
printf ( "Table: %sn", $val->table), 
printf ( "max. Len: %dn", $val->max length); 
// Free result set 


mysqli free result($result), 


mysqli close($con), 
?> 


定义 和 用 法 
mysqli_fetch_fields() 函数 返回 结果 集中 代表 字段 (FU) 的 对 象 的 数组 。 


语法 


mysgdlifetch fields( result); 


参数 描述 
必需 。 规 定 由 mysqli_query()、mysqli_store_result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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返回 包含 字段 定义 信息 的 对 象 。 如 果 没有 可 用 信息 则 返回 FALSE。 该 对 象 有 下 
列 属 性 : name - 列 名 orgname - 原始 的 列 名 〈 如 果 指 定 了 别名 ) table -RE 
orgtable - 原始 的 表 名 (ARE T 314) max_length -字段 的 最 大 宽度 
length - 在 表 定 义 中 规定 的 字段 宽度 charsetnr - 字段 的 字符 集 号 flags -F 
段 的 位 标志 type - 用 于 字段 的 数据 类 型 decimals - 整数 字段 ， 小 数 点 后 的 位 
数 


5+ 


PHP mysqli fetch lengths() HŽ% 


实例 
返回 站 果 集中 的 字段 长度 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 

t 

echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT * FROM Persons ORDER BY Lastname"; 
if ($result-mysqli guery($con, $sg1)) 

{ 

$row=mysqli_fetch_row($result); 


// Display field lengths 
foreach (mysqli_fetch_lengths($result) as $i=>$val) 


{ 
printf ("Field %2d has length: %2dn",$i+1, $val); 
} 


// Free result set 
mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


M : 
mysqli_fetch_lengths() 函数 返回 结果 集中 的 字段 长 度 。 


语法 


mysglifetch lengths( result); 


参数 描述 
T 必需 。 规 定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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: 如 果 整 数 表示 每 个 字段 CM) 的 长 度 则 返回 数组 ， 如 果 发 生 错 误 则 返回 
返回 值 : FALSE, 


PHP mysgli fetch lengths() ES 578 


PHP mysgli fetch. object() 函数 


实例 
返回 结果 集中 的 当前 行 ， 然 后 输出 每 个 字段 的 值 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 

> ($objzmysqli fetch object($result)) 

TA (4s)n", $obj ->Lastname, $obj ->Age) ; 


// Free result set 
mysqli free result($result); 


mysqli close($con), 
?> 


pius N 
mysqli_fetch_object() HAM +k SR S rn Bx (S SB fT, HEA RRE 


注释 : 该 图 数 返回 的 字段 名 是 区 分 大 小 写 的 。 


语法 
mysqlifetch_object(_result,classname, params); 


参数 描述 


必需 。 规 定 由 mysqli_query()、mysqli_store_result() 或 
mysqli use result() 返回 的 结果 集 标 识 符 。 


classname ”可 选 。 规 定 要 实例 化 的 类 名 称 ， 设 置 属性 并 返回 。 


params 可 选 。 规 定 一 个 传 给 classname 对 象 构造 器 的 参数 数组 。 


result 


7X AK im Ť 


返回 带 有 所 取得 行 的 字符 串 属 性 的 对 象 。 如 果 在 结果 集中 没有 更 多 的 行 则 返 
回 NULL。 


5+ 


在 PHP 5.0.0 中 新 增 了 作为 不 同 对 象 返 回 的 功能 。 


PHP mysgqli fetch row() 2 


实例 
从 结果 集中 取得 行 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 


// Fetch one and one row 
while ($row-mysqli fetch row($result)) 


{ 
printf ("%s (%s)n",$row[0],$row[1]); 
// Free result set 


mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


定义 和 用 法 
mysqli_fetch_row() 画 数 从 结果 集中 取得 一 行 ， 并 作为 枚 举 数 组 返回 。 


语法 


mysgqlifetch row( result); 


参数 描述 
pay 必需 。 规 定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 


技术 细节 


返回 值 : 返回 一 个 与 所 取得 行 相对 应 的 字符 串 数 组 。 如 果 在 结果 集中 没有 更 多 的 行 则 
返回 NULL. 


PHP mysagli field count() 函数 


实例 
假设 我 们 有 一 个 "Friends" 表 ， 其 中 有 3 个 字段 20 行 记 录 。 返 回 最 近 查 询 的 列 数 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


J 


mysqli guery($con, "SELECT * FROM Friends"), 
// Get number of columns - will always return 3 
mysgli field count($con); 


mysqli close($con), 
?> 


s 、 : 
mysqli_field_count() 函数 返回 最 近 查 询 的 列 数 。 


语法 


mysqlifield_count(_connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 返回 一 个 表示 结果 集中 列 数 的 整数 。 
PHP 版 本 : 5+ 


PHP mysqli field seek() 函数 


设置 结果 集中 第 一 个 字段 ( 列 ) 的 字段 指针 ， 然 后 通过 mysqli_fetch_field() 获取 字段 信息 并 
输出 字段 名 称 、 表 格 和 最 大 长 度 : 
<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


H 

$sql-"SELECT Lastname,Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 

// Get field info for 1st column ("Lastname") 

mysqli field seek($result,0), 
$fieldinfozmysgli fetch field($result); 

printf("Name: %sn",$fieldinfo->name) ; 

printf("Table: %sn",$fieldinfo->table); 

printf("max. Len: %dn",$fieldinfo->max_length) ; 

// Free result set 


mysqli_free_result($result); 


mysqli close($con), 
?> 


PES N 
mysqli_field_seek() KAŠE Ee RHEE 7) EFRA E. 


吾 法 


mysgdlifield seek( result fieldnr); 


参数 描述 
必需 ESS: mysgli store result() 或 mysgli use result() 3x 


It HI 
fieldnr ”必需 。 规 定 字段 号 。 必 须 介 于 0 和 字段 数 -1 之 间 。 


技术 细节 


返回 值 : 如 果 成 功 则 返回 TRUE, MRAM FALSE. 
PHP 版 本 : 5+ 


PHP mysali field tell() 函数 


V 


实例 


取得 所 有 字段 的 字段 信息 ， 然 后 通过 mysgli field tell() 取得 当前 字段 并 输出 字段 名 称 、 表 格 
和 最 大 长 度 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


J 


$sql-"SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 


if ($result-mysqli query($con,$sq1)) 
{ 


// Get field info for all fields 
while ($fieldinfo=mysqli_fetch_field($result)) 


// Get field cursor position 
$currentfield=mysqli_field_tell($result); 


printf("Column %d:n", $currentfield); 
printf("Name: %sn", $fieldinfo->name); 


printf("Table: %sn", $fieldinfo->table); 
J 


// Free result set 
mysqli free result($result), 
J 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_field_tell() 函数 返回 字段 指针 的 位 置 。 


语法 
mysgdlifield tell( result); 


BR 描述 


必需 。 规 定 由 mysqli_query()、mysqli_store_result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 


result 


技术 细节 


返回 值 : 返回 字段 指针 的 当前 偏 移 量 。 
PHP 版 本 : 5+ 


PHP mysqli free result() 2% 


实例 
从 结果 集中 取得 行 ， 然 后 释放 结果 内 存 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysgli query($con,$sq1)) 


// Fetch one and one row 
while ($row-mysqli fetch row($result)) 


{ 
printf ("%s (%s)n",$row[0],$row[1]); 
// Free result set 


mysqli_free_result($result); 


mysqli_close($con) ; 
?> 


定义 和 用 法 
mysgli free result() 函数 释放 结果 内 存 。 
语法 


mysalifree result( result); 


参数 描述 
pay 必需 。 规 定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 


回 的 结果 集 标 识 符 。 


技术 细节 
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返回 值 没有 返回 值 。 
PHP 版 本 : 5+ 


PHP mysqli free result() 函数 589 


PHP mysagli get charset() 2X 


实例 
返回 带 有 属性 的 字符 集 对 象 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


} 
var dump(mysgli get charset($con)); 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_get_charset() 函数 返回 字符 集 对 象 。 


mysgliget charset( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


7X A im Ť 


返回 带 有 下 列 属 性 的 字符 集 对 象 : ”charset - 字符 集 名 称 collation - 排序 规则 
返回 名 称 dir -被 获取 的 目 录 字 符 集 或 者 ja min length - 以 字 节 计 的 最 小 字符 长 度 


fü : max length - 以 字 节 计 的 最 大 字符 长 度 number - 内 部 字符 集 数 state - 字符 集 
状态 

PHP 

版 5.1+ 


PHP mysgli get client info() 2 


实例 


返回 MySQL 客户 端 库 版 本 : 


<?php 


echo mysqli get client info(); 


?> 


定义 和 用 法 


mysqli_get_client_info() HURE] MySQL 客户 端 库 版 本 。 


语法 


mysgliget client info( connection); 


参数 


connection 


技术 细节 


返回 值 : 
PHP 版 本 : 


可 选 。 规 定 要 使 用 的 MySQL 连接 。 


返回 一 个 表示 MySQL 客户 端 库 版 本 的 字符 串 。 


PHP mysgli get client stats() 2 


返回 有 关 客 户 端 每 个 进程 的 统计 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
print r(mysgli get client stats()); 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_get_client_stats() IŠUREGRK 户 端 每 个 进程 的 统计 。 


返回 值 : 如 果 成 功 则 返回 一 个 带 有 客户 端 统计 的 数组 ， 如 果 失 败 则 返回 FALSE. 
PHP 版 本 : 5.3+ 


PHP mysali get client version() EX2X 


实例 
将 MySQL 客户 端 库 版 本 作为 整数 返回 : 


<?php 
echo mysgli get client version(); 


?> 


M. : 
mysqli_get_client_version() 函数 业 MySQL 客户 端 库 版 本 作为 整数 返回 。 


MySQL 客户 端 库 版 本 将 按照 以 下 格式 返回 : 主要 版 本 10000 + 次 要 版 本 100 + 子 版 本 。 例 
如 : 5.1.0 将 返回 50100, 


语法 


mysgliget client version( connection), 


参数 描述 
connection 可 选 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 返回 一 个 表示 MySQL 客 户 端 库 版 本 的 整数 。 
PHP 版 本 : 5+ 


PHP mysgli get connection stats() HŽ% 


实例 
返回 有 关 客 户 端 连 接 的 统计 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
print r(mysqli get connection stats($con)); 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_get_connection_stats() 函数 返回 有 关 客 户 端 连 接 的 统计 。 


mysgliget connection stats( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


DUK Z8 


返回 值 : 如 果 成 功 则 返回 一 个 带 有 连接 统计 的 数组 ， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5.3+ 


PHP mysgli get connection stats() HŽ% 


实例 
返回 有 关 客 户 端 连 接 的 统计 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
print r(mysqli get connection stats($con)); 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_get_connection_stats() 函数 返回 有 关 客 户 端 连 接 的 统计 。 


mysgliget connection stats( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


DUK Z8 


返回 值 : 如 果 成 功 则 返回 一 个 带 有 连接 统计 的 数组 ， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5.3+ 


PHP mysgli get host info() KŻ% 


实例 
返回 MySQL 服务 器 主机 名 和 连接 类 型 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 

echo "Failed to connect to MySQL: " . mysgli connect error(); 


echo mysgli get host info($con), 


EE BO SPALA: 
m 、 i 
mysqli get host info() FAŠURIE] MySQL 服务 器 主机 名 和 连接 类 型 。 


语法 


mysgliget host info( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


DUK Z8 


返回 值 : 返回 一 个 表示 MySQL 服务 器 主机 名 和 连接 类 型 的 字符 串 。 
PHP 版 本 : 5+ 


PHP mysgli get proto info() Až 


实例 
返回 MySQL 协议 版 本 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
echo mysgli get proto info($con), 


mysqli close($con), 
?> 


定义 和 用 法 


mysgli get proto info() HURE MySQL 协议 版 本 。 


mysgliget proto info( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


DUK Z8 


返回 值 : 返回 一 个 表示 MySQL 协议 版 本 的 整数 。 
PHP 版 本 : 5+ 


PHP mysqli get server info() 函数 


实例 
返回 MySQL 服务 器 版 本 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
echo mysgli get server info($con), 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_get_server_info() HŽUR E| MySQL 服务 器 版 本 。 


mysgliget server info( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


DUK Z8 


返回 值 : 返回 一 个 表示 MySQL 服务 器 版 本 的 字符 串 。 
PHP 版 本 : 5+ 


A 


PHP mysgli get server version() Až 


例 


将 MySQL 服务 器 版 本 作为 整数 返回 : 


将 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


echo mysqli get server version($con); 


mysqli close($con), 
?> 


中 、 : 
mysqli_get_server_version() 函数 将 MySQL 服务 器 版 本 作为 整数 返回 。 


MySQL 服务 器 版 本 将 按照 以 下 格式 返回 : 主要 版 本 10000 + 次 要 版 本 100 + 子 版 本 。 例 如 : 
5.1.0 将 返回 50100。 


语法 


mysgliget server version( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 返回 一 个 表示 MySQL 服务 器 版 本 的 整数 。 
PHP 版 本 : 5+ 


iva 


PHP mysali info() 函数 


返回 有 关 最 近 执 行 查 询 的 信息 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 

t 

echo "Failed to connect to MySQL: " . mysgli connect error(); 

} 

// Perform queries 

$sqli="CREATE TABLE testPersons LIKE Persons" 

mysqli_query($con, $sql1); 

$sql2-"INSERT INTO testPersons SELECT * FROM Persons ORDER BY LastName LIMIT 10" 
mysqli_query($con, $sql2); 


// Print info about most recently executed query 
echo mysqli_info($con); 


mysqli close($con), 
?> 


M. : 
mysqli_info() 范 数 返回 有 关 最 近 执 行 查询 的 信息 。 


该 图 数 作用 于 下 列 查 询 类 型 : 


INSERT INTO...SELECT... 

INSERT INTO...VALUES (...),(...),(..:) 
LOAD DATA INFILE ... 

ALTER TABLE ... 

UPDATE ... 


语法 
mysaliínfo( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 返回 一 个 字符 串 ， 包 含有 关 最 近 执 行 查询 的 额外 信息 。 
PHP 版 本 : 5+ 


PHP mysali init() 函数 


实例 
mysdli init() 函数 的 使 用 : 


<?php 

$conzmysgli init(), 

if (!$con) 

{ 

die("mysqli_init failed"); 

if (!mysqli_real_connect($con, "localhost", "my user", "my password", "my db")) 


die( "Connect Error: " . mysgli connect error()); 


} 


mysqli_close($con); 
?> 


定义 和 用 法 


mysqli_init() 函数 初始 化 MySQLi 并 返回 mysqli_real_connect() 使 用 的 对 象 。 


mmysali_init(); 


7X AK 28 m 


返回 值 : 返回 一 个 对 象 。 
PHP 版 本 : 5+ 


PHP mysali insert id() HŽ% 


实例 
假设 Persons 表 有 一 个 自动 生成 的 ID 字段。 返回 最 后 一 次 查询 中 的 ID : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Glenn','Quagmire',33)"); 


// Print auto-generated id 
echo "New record has id: " . mysqli_insert_id($con); 


mysqli_close($con); 
?> 


定义 和 用 法 


mysqli_insert_id() 函数 返回 最 后 一 个 查询 中 自动 生成 的 ID (通过 AUTO. INCREMENT + 
成 ) 。 


语法 


mysgliinsert id( connection), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 一 个 在 最 后 一 个 查询 中 自动 生成 的 带 有 AUTO INCREMENT 字段 值 的 整 
数 。 如 果 数 字 > 最 大 整数 值 ， 它 将 返回 一 个 字符 串 。 如 果 没 有 更 新 或 没有 
AUTO INCREMENT 字段 ， 将 返回 0. 


PHP mysali kill() 函数 


实例 
返回 当前 连接 的 线程 ID， 然 后 闲 死 连接 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Get thread id 
$t_id=mysqli_thread_id($con); 


// Kill connection 
mysqli_kill($con,$t_id); 
?» 


ps 、 N 
mysqlikill() 范 数 请 求 服务 器 杀 死 一 个 由 _processid 参数 指定 的 MySQL 线程 。 


语法 


mysqlikill(_connection, processid); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
processid 必需 。 由 mysqli_thread_id() 返回 的 线程 |D。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysgli more results() 函数 
定义 和 用 法 
mysqli_more_results() 函数 检查 一 个 多 查询 是 否 有 更 多 的 结果 。 


语法 


mysglimore results( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


[RR Ť 


返回 值 : 如 果 成 功 则 返回 TRUE, WRK KURIE] FALSE. 
PHP 版 本 : 5+ 


PHP mysgqli multi query() HŽ% 


实例 
执行 多 个 针对 数据 库 的 查询 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 
} 

$sgl = "SELECT Lastname FROM Persons ORDER BY LastName;"; 
$sql .= "SELECT Country FROM Customers"; 


// Execute multi query 
if (mysqli multi guery($con, $sg1)) 
{ 


do 
{ 


// Store first result set 
if ($result=mysqli_store_result($con)) 


while ($row=mysqli_fetch_row($result)) 
{ 
printf ("%sn", $row[01): 


mysqli free result($con), 
while (mysqli next result($con)); 


mysqli close($con), 
?> 


= . i 
mysgli multi query() 函数 执行 一 个 或 多 个 针对 数据 库 的 查询 。 多 个 查询 用 分 号 进行 分 隔 。 


语法 


mysqlimulti_query(_connection, query); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
guery 必需 。 规 定 一 个 或 多 个 查询 ， 用 分 号 进行 分 隔 。 


技术 细节 


返回 值 : 如 果 第 一 个 查询 失败 则 返回 FALSE. 
PHP 版 本 : 5+ 


PHP mysgqli next result() X2 


实例 
执行 多 个 针对 数据 库 的 查询 。 请 使 用 mysali_next_result() HARES F — DRK : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 
J 

$sql - "SELECT Lastname FROM Persons ORDER BY LastName;"; 
$sql .= "SELECT Country FROM Customers"; 


// Execute multi query 
if (mysqli multi guery($con, $sg1)) 
{ 


do 


{ 
// Store first result set 


if ($result=mysqli_store_result($con)) 
while ($row=mysqli_fetch_row($result)) 
{ 

printf ("%sn", $row[01): 


mysqli free result($con), 
while (mysqli next result($con)); 


mysqli close($con), 
?> 


Lr. N 

mysgli next result() 函数 为 mysgli multi query() 准备 下 一 个 结果 集 。 
语法 

mysglinext result( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 如 果 成 功 则 返回 TRUE, MRAM FALSE. 
PHP 版 本 : 5+ 


PHP mysgli num fields() 函数 


实例 
返回 结果 集中 字段 CU) 的 数量 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 


if ($result-mysqli query($con,$sq1)) 
t 


// Return the number of fields in result set 
$fieldcountzmysqli num fields($result), 
printf("Result set has %d fields.n",$fieldcount); 
// Free result set 

mysqli free result($result); 


mysqli close($con), 
?> 


定义 和 用 法 
mysgdli num fields() 函数 返回 结果 集中 字段 ( 列 ) 的 数量 。 


语法 


mysglinum fields( result); 


参数 描述 
RT 必需 。 规 定 由 mysgdli guery(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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返回 值 : 返回 结果 集中 字段 的 数量 。 
PHP 版 本 : 5+ 


W3School PHP 参考 手册 


PHP mysgli num fields() 函数 612 


PHP mysgli num rows() HŽ% 


实例 
返回 结果 集中 行 的 数量 : 


<?php 
$con=mysqli_connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


t 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


$sql="SELECT Lastname, Age FROM Persons ORDER BY Lastname"; 
if ($result-mysqli query($con,$sq1)) 

// Return the number of rows in result set 
$rowcount-mysqli num rows($result); 

printf("Result set has %d rows.n",$rowcount); 


// Free result set 
mysqli free result($result); 


mysqli close($con), 
?> 


定义 和 用 法 
mysqli num rows() 画 数 返 回 结果 集中 行 的 数量 。 


语法 


mysgdlinum rows( result); 


参数 描述 
RT 必需 。 规 定 由 mysqli_query(), mysqli store result() 或 mysgli use result() 3x 
回 的 结果 集 标识 符 。 
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返回 值 : 返回 结果 集中 行 的 数量 。 
PHP 版 本 : 5+ 


W3School PHP 参考 手册 


PHP mysqli num rows() ER2& 614 


PHP mysqli_options() 2% 


实例 
打开 一 个 到 MySQL 服务 器 的 新 连接 : 


<?php 
$conzmysgli init(), 
if (!$con) 


{ 
die("mysqli_init failed"); 


mysqli_options($con, MYSQLI_READ_DEFAULT_FILE, "myfile.cnf"); 
if (!mysqli_real_connect($con, "localhost", "my user", "my password", "my db")) 


die( "Connect Error: " . mysgli connect error()); 


J 


mysqli close($con), 
?> 


= . N 

mysqli_options() 函数 设置 额外 的 连接 选项 ， 用 于 影响 连接 行为 。 

mysgli options() 函数 可 以 被 调用 若干 次 来 设置 若干 个 选项 。 

注释 : mysqli_options() 函数 可 以 在 mysali_init() 之 后 和 mysali real connect() 之 前 被 调用 。 
语法 


mysqlioptions(_connection, option, value); 


参数 


connection 
option 


value 


技术 细节 


返回 值 : 
PHP 版 本 : 


更 新 日 志 : 


必需 。 规 定 要 使 用 的 MySQL 连接 。 


必需 。 规 定 要 设置 的 选项 。 可 以 是 下 列 值 中 的 一 个 : 

MYSQLI OPT CONNECT. TIMEOUT - 以 秒 为 单位 的 连接 超时 时 间 
MYSQLI OPT LOCAL INFILE - 启用 /禁用 LOAD LOCAL INFILE 
MYSQLI INIT COMMAND - 在 连接 到 MySQL 服务 器 之 后 的 执行 命令 

MYSOLI READ DEFAULT FILE - 从 已 命名 的 文件 而 不 是 my.cnf 中 读 取 选 项 
MYSOLI READ DEFAULT GROUP - 从 my.cnf 或 者 
MYSQLI READ DEFAULT FILE 中 指定 的 文件 中 的 已 命名 组 中 读 取 选 项 
MYSOLI SERVER PUBLIC KEY - 基于 SHA-256 认证 的 RSA 公共 密 钥 文件 





必需 。 规 定 option 的 值 。 


如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE. 
5+ 


在 PHP 5.5 中 新 增 了 MYSQLI SERVER PUBLIC KEY 选项 。 


Ne 


PHP mysqli ping() 2% 


实例 
进行 一 个 服务 器 连接 : 
<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"), 


// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


J 


// Check if server is alive 
if (mysqli ping($con)) 
1 


echo "Connection is ok!"; 


J 


else 


{ 


echo "Error: ". mysgli error($con), 


J 


mysqli close($con), 
?> 


定义 和 用 法 


mysqli_ping() 画 数 进行 一 个 服务 器 连接 ， 如 果 连 接 已 断 开 则 尝试 重新 连接 。 


mysgdliping( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysgqli query() 2% 


实例 


执行 针对 数据 库 的 查询 : 


<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 


J 


// Perform queries 
mysqli guery($con, "SELECT * FROM Persons"); 


mysqli guery($con, "INSERT INTO Persons (FirstName,LastName,Age) 


VALUES ('Glenn', 'Quagmire',33)"); 


mysqli_close($con) ; 


?> 


定义 和 用 法 


mysqli_query() ER 


吾 法 


数 执行 某 个 针对 数据 库 的 查询 。 


mysgqliquery( connection,query,resultmode); 


参数 
connection 


guery 


resultmode 


技术 细节 


描述 
必需 。 规 定 要 使 用 的 MySQL 连接 。 
必需 ， 规 定 查 询 字符 串 。 
HE. 一 个 常量 。 可 以 是 下 列 值 中 的 任意 一 


MYSOLI USE RESULT 


果 需要 检索 大 量 数据 ， 请 使 用 这 个 ) VEMM  — (默认 ) 


(如 


4+ xt BXZJf SELECT. SHOW, DESCRIBE = EXPLAIN 查询 ， 将 返回 一 个 
mysgli result stát. HIERIE, RG] TRUE. MRAK, NILE 
FALSE, 


54 


在 PHP 5.3.0 中 新 增 了 异步 查询 的 功能 。 


PHP mysagli real connect() 函数 


实例 
打开 一 个 到 MySQL 服务 器 的 新 连接 : 


<?php 
$conzmysgli init(), 
if (!$con) 


{ 
die("mysqli_init failed"); 


if (!mysqli_real_connect($con, "localhost", "my user", "my password", "my db")) 


die( "Connect Error: " . mysgli connect error()); 


} 


mysqli_close($con); 
?> 


ch. : 
mysqli_real_connect() 函数 打开 一 个 到 MySQL 服务 器 的 新 连接 。 
mysgli real connect() 函数 与 mysgli connect() 函数 在 以 下 几 个 方面 存在 差异 : 
e mysgli real connect() 要 求 一 个 由 mysqli_init() 创建 的 有 效 的 对 象 。 
e mysgli real connect() 可 以 与 mysqli_options() 一 同 使 用 来 设置 连接 的 不 同 选项 。 
e mysgli real connect() 有 一 个 flag 参数 。 
语法 


mysqlireal_connect(_connection, host, username,password,dbname, port, socket, flag); 


BR 
connection 
host 
username 
password 
dbname 
port 


socket 


flag 


技术 细节 


返回 值 : 


PHP 版 本 : 





必需 。 规 定 要 使 用 的 MySQL 连接 。 

可 选 。 规 定 主机 名 或 IP 地 址 。 

可 选 。 规 定 MySQL 用 户 名 。 

可 选 。 规 定 MySQL 密码 。 

可 选 。 规 定 要 使 用 的 默认 数据 库 。 

可 选 。 规 定 尝试 连接 到 MySQL 服务 器 的 端口 号 。 

可 选 。 规 定 socket 或 要 使 用 的 已 命名 pipe。 

可 选 。 规 定 不 同 的 连接 选项 。 可 能 的 值 : MYsQLI_CLIENT_coMPRESS - 使 用 





压缩 协议 MYSOLI cLIENT FOUND ROWS - 返回 匹配 的 行 数 (不 是 受 影响 的 行 
数 ) MYSQLI CLIENT IGNORE SPACE - 在 加 数 名 后 允许 空格 ， 使 函数 名 保留 
=Æ MYSQLI CLIENT INTERACTIVE - 在 关闭 连接 之 前 允许 不 活动 的 
interactive timeout 秒 wvsoLr cLrENT ssi. -使 用 SSL 加 密 





如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
5+ 


PHP mysgli real escape string() 2 


实例 
转 义 字符 串 中 的 特殊 字符 : 
<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"), 


// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


J 


mysqli guery($con, "CREATE TABLE myPersons LIKE Persons"); 
$newpers-"Da "Silva" 


// This query will fail, cause we did not escape $newpers 
mysqli guery($con, "INSERT into myPersons (Lastname) VALUES ('$newpers')"); 


$newpers-mysgli real escape string($con, $newpers); 


// This query will work, cause we escaped $newpers 
mysqli guery($con, "INSERT into myPersons (Lastname) VALUES ('$newpers')"); 


mysqli close($con), 
?> 


定义 和 用 法 


mysgli real escape string() 函数 转 义 在 SQL 语句 中 使 用 的 字符 串 中 的 特殊 字符 。 


语法 
mysaglireal escape string( connection,escapestring); 
参数 描述 


connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


必需 。 要 转 义 的 字符 串 。 编 码 的 字符 是 NUL (ASCII 0) 、\n、 V, 


ESO \、" "和 Control-Z 


技术 细节 


W3School PHP 参考 手册 


返回 值 : 返回 已 转 义 的 字符 串 。 
PHP 版 本 : 5+ 


PHP mysgli real escape string() 函数 623 


PHP mysqli refresh() E325 


定义 和 用 法 


mysqli_refresh() 函数 刷新 表 或 缓存 ， 或 者 重 置 复制 服务 器 信息 。 


语法 
mysglirefresh( connection, options); 


参数 描述 
connection ”必需 。 规 定 要 使 用 的 MySQL 连接 。 


要 刷新 的 选项 。 可 以 是 下 列 中 的 一 个 或 多 个 (用 OR DIR) 
MYSOLI REFRESH GRANT - 刷新 授权 表 MYSOLI REFRESH Loc - 刷新 记录 
MYSOLI REFRESH TABLES - 刷新 表 缓 存 MYSOLI REFRESH HosTS - 刷新 主机 组 
options ff MYSOLI REFRESH STATUS - 重 置 状态 变量 MYSOLI REFRESH THREADS - 刷新 
线程 缓存 MYSOLI REFRESH SLAVE - 重 置 主 服务 器 信息 ， 重 启 从 服务 器 
MYSOLI REFRESH MASTER - 移 除 二 进 制 日 志 索 引 中 的 二 进 制 日 志文 件 ， 并 截 


断 索 引文 件 。 
技术 细节 
返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE. 


PHP 版 本 : 5.3+ 


PHP mysali rollback() 2% 


实例 
关闭 自动 提交 ， 做 一 此 查询， 提交 查询 ， 然 后 回 梁 当 前 事务 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Set autocommit to off 

mysqli_autocommit($con, FALSE), 

// Insert some values 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Peter','Griffin',35)"); 

mysqli_query($con, "INSERT INTO Persons (FirstName, LastName, Age) 
VALUES ('Glenn','Quagmire',33)"); 


// Commit transaction 
mysqli_commit($con); 


// Rollback transaction 
mysqli_rollback($con); 


// Close connection 
mysqli_close($con); 
?> 


定义 和 用 法 
mysdli rollback() 范 数 回 滚 指定 数据 库 连 接 的 当前 事务 。 


提示 : 请 查看 mysqli_commit() 函数 ， 用 于 提交 指定 数据 库 连 接 的 当前 事务 。 请 查看 
mysgli autocommit() 函数 ， 用 于 开启 或 关闭 自动 提交 数据 库 修改 。 


语法 


mysgdlirollback( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysqli_rollback() 函数 626 


PHP mysqli select db() HŽ% 


实例 
更 改 连 接 的 默认 数据 库 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
// ...some PHP code for database "my db"... 


// Change database to "test" 
mysqli select db($con,"test"); 


// ...some PHP code for database "test"... 


mysqli close($con), 
?> 


定义 和 用 法 
mysqli_select_db() 函数 用 于 更 改 连接 的 默认 数据 库 。 


语法 


mysgliselect db( connection,dbname), 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
dbname 必需 ， 规 定 要 使 用 的 默认 数据 库 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP mysgqli set charset() 函数 


实例 


设置 默认 客户 端 字符 集 : 


Sey 


<?php 
$con=mysqli_connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Change character set to utf8 
mysqli_set_charset($con, "utf8"); 


mysqli_close($con); 
?> 


= 、 : 
mysgli set charset() 函数 规定 当 与 数据 库 服 务 器 进行 数据 传送 时 要 使 用 的 默认 字符 集 。 


注释 : 在 Windows 平台 上 使 用 该 函数 ， 您 需要 MySQL 客户 端 库 4.1.11 或 以 上 版 本 
(MySQL 5.0 需要 5.0.6 或 以 上 版 本 ) 。 


语法 


mysqliset_charset(_connection, charset); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
charset 必需 。 规 定 默认 字符 集 。 
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返回 值 : 如 果 成 功 则 返回 TRUE， 如 果 失 败 则 返回 FALSE. 
PHP 版 本 : 5.0.5+ 


PHP mysqli_sqlstate() 函数 


实例 
返回 最 后 一 个 MySQL 操作 的 SQLSTATE 错误 代码 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


J 


// Table Persons already exists, so we should get an error 

$sql-"CREATE TABLE Persons (Firstname VARCHAR(30),Lastname VARCHAR(30),Age INT)" 
if (!mysqli query($con,$sq1)) 

{ 


echo "SQLSTATE error: ". mysqli_sqlstate($con); 
J 


// Close connection 
mysqli close($con), 
?> 


mo . S 
mysqli_sqlstate() FAŠURIEIAZE — Ab SQLSTATE 错误 代码 。 


错误 代码 包含 五 个 字符 。"00000" 表明 没有 错误 。 值 由 ANSI SQL 和 ODBC 指定 。 


mysglisgistate( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
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返回 值 : 返回 一 个 包含 最 后 一 个 错误 的 SQLSTATE 错误 代码 的 字符 串 。 
PHP 版 本 : 5+ 


PHP mysagli ssl set() E325 


实例 
创建 SSL 连接 : 


<?php 
$conzmysgli init(), 
if (!$con) 


{ 
die("mysqli_init failed"); 


mysqli ssl set($con, "key.pem", "cert.pem", "cacert.pem", NULL, NULL) ; 
if (!mysqli real connect($con," "localhost", "my user", "my password", "my db")) 


die( "Connect Error: " . mysgli connect error()); 


} 
// Some queries... 


mysqli_close($con); 
?> 


ch. : 

mysgli ssl set() BAŠTA T6JE SSL 224i., AM, ARARAT AA OpenSSL 支持 时 才 
有 效 。 

注释 : 该 函数 必须 在 mysgli real connect() 之 前 调用 。 


注释 : 在 PHP 5.3.3 之 前 的 版 本 ，MySQL Native Driver 不 支持 SSL。 自 PHP 5.3+ 起 ， 在 微 
软 Windows 上 默认 启用 MySQL Native Driver, 


语法 


mysqliss/_set(_connection, key,cert,ca,capath, cipher); 


参数 描述 





connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 
key 必需 。 规 定 密 钥 文件 的 路 径 名 。 
cert 必需 。 规 定 认 证 文件 的 路 径 名 。 
ca 必需 。 规 定 认证 授权 文件 的 路 径 名 。 
capath 必需 。 规 定 包含 PEM 格式 的 可 信 SSL CA 认证 的 目录 的 路 径 名 。 
cipher 必需 。 规 定 用 于 SSL 加 密 的 可 用 密码 列表 。 
技术 细节 
返回 总 是 返回 TRUE, WR SSL 安装 不 正确 ， 当 您 尝试 连接 的 时 
fü: /£, mysgli real connect() 将 返回 一 个 错误 。 


PHP mysali stat() HŽ% 


实例 
创建 SSL 连接 : 


<?php 


$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 
if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysqli connect error(); 
} 
echo "System status: ". mysgli stat($con), 


mysqli close($con), 


2» 


定义 和 用 法 


mysqli_stat() HURE HARAS. 


语法 


mysglistat( connection), 


参数 


connection 
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返回 值 : 
PHP 版 本 : 


5+ 


必需 。 规 定 要 使 用 的 MySQL 连接 。 


返回 一 个 描述 服务 器 状态 的 字符 串 。 如 果 发 生 错误 则 返回 FALSE, 


PHP mysgqli stmt init() 函数 


44 


实例 
初始 化 声明 并 返回 mysgli stmt prepare() 使 用 的 对 象 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"), 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 
$city="Sandnes"; 


// Create a prepared statement 
$stmt=mysqli_stmt_init($con); 


if (mysqli stmt prepare($stmt, "SELECT District FROM City WHERE Name=?") ) 
// Bind parameters 
mysqli_stmt_bind_param($stmt,"s",$city); 


// Execute query 
mysqli stmt execute($stmt), 


// Bind result variables 
mysqli stmt bind result($stmt, $district), 


// Fetch value 
mysqli stmt fetch($stmt), 


printf ("%s is in district %s",$city, $district), 
// Close statement 


mysqli stmt close($stmt), 
} 


mysqli close($con), 
?» 


定义 和 用 法 
mysagli stmt init() 画 数 初始 化 声明 并 返回 mysqli_stmt_prepare() 使 用 的 对 象 。 


语法 


mysglistmt init( connection); 


BR 


connection 


技术 细节 


返回 值 : 
PHP 版 本 : 


必需 。 规 定 要 使 用 的 MySQL 连接 。 


返回 一 个 对 象 。 
5+ 


PHP mysqli thread id() 2X 


实例 
返回 当前 连接 的 线程 ID， 然 后 闲 死 连接 : 


<?php 

$conzmysgli connect("localhost", "my user", "my password", "my db"); 
// Check connection 

if (mysqli connect errno($con)) 


echo "Failed to connect to MySQL: " . mysgli connect error(); 


} 


// Get thread id 
$t_id=mysqli_thread_id($con); 


// Kill connection 
mysqli_kill($con,$t_id); 
?» 


ri. N 
mysqli_thread_id() 函数 返回 当前 连接 的 线程 ID， 然 后 使 用 mysqli_kill() HAA DK. 


注释 : 如 果 连 接 被 损坏 且 重 新 连接 ， 线 程 ID 将 会 改变 。 因 此 ， 仅 当 您 需要 的 时 候 才 获取 线程 
ID. 


语法 


mysglithread id( connection); 


参数 描述 
connection 必需 。 规 定 要 使 用 的 MySQL 连接 。 


技术 细节 


返回 值 : 返回 当前 连接 的 线程 ID。 
PHP 版 本 : 5+ 


PHP mysgqli thread safe() 2X 
定义 和 用 法 

mysgli thread safe() 本 数 返回 是 否 将 客户 端 库 编 译 成 thread-safe. 
语法 

mysalithread safe(); _ 
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返回 值 : RE 户 端 库 是 thread-safe 则 返回 TRUE， 否 则 返回 FALSE, 
PHP 版 本 : 5+ 


PHP PDO 


PHP 数据 对 象 (PDO) 扩展 为 PHP 访 问 数据 库 定义 了 一 个 轻 量 级 的 一 致 接口 。 


PDO 提供 了 一 个 数据 访问 抽象 屋 ， 这 意味 着 ， 不 管 使 用 哪 种 数据 库 ， 都 可 以 用 相同 的 画 数 
(方法 ) 来 查询 和 获取 数据 。 


PDO 随 PHP5.1 发 行 ， 在 PHP5.0 的 PECL 扩 展 中 也 可 以 使 用 ， 无 法 运行 于 之 前 的 PHP 版 本 。 


PDO 222% 


你 可 以 通过 PHP 的 phpinfo() 函数 来 查看 是 否 安 装 了 PDO 扩 展 。 


在 Unix 系统 上 安装 PDO 
在 Unix 上 或 Linux 上 你 需要 添加 以 下 扩展 : 


extension-pdo.so 


Windows FH è 


PDO 和 所 有 主要 的 驱动 作为 共享 扩展 随 PHP 一 起 发 布 ， 要 激活 它们 只 需 简单 地 编辑 php.ini 
文件 ， 并 添加 以 下 扩展 : 


extension-php pdo.dll 


除 此 之 外 还 有 以 下 对 应 的 各 种 数据 库 扩 展 : 


;extension-php pdo firebird.dll 
;extension-php pdo informix.dll 
;extension-php pdo mssql.dll 
;extension-php pdo mysql.dll 
;extension-php pdo oci.dll 
;extension-php pdo oci8.dll 
;extension-php pdo odbc.dll 
;extension-php pdo pgsql.dll 
;extension-php pdo sqlite.dll 


在 设 定好 这 些 配置 后 ， 我 们 需要 重启 PHP 或 Web 服 务 器 。 
接 下 来 我 们 们 来 看 下 具体 的 实例 ， 以 下 为 使 用 PDO 连 接 MySql 数 据 库 的 实例 : 


<?php 


$dbms='mysql'; // 数 据 库 类 型 
$host-"localhost": // 数 据 库 主机 名 
$dbName-" test": // 使 用 的 数据 库 
$user='root'; // 数 据 库 连 接 用 户 名 


$pass-''; 
$dsn="$dbms :host=$host ; dbnamez$dbName" ; 


try { 


// 对 应 的 密码 


$dbh = new PDO($dsn, $user, $pass): // 初 始 化 一 个 PDO 对 象 
echo "连接 成 功 <br/>"， 

/* 你 还 可 以 进行 一 次 搜索 操作 

foreach ($dbh->guery( "SELECT * from FOO") as $row) { 

print r($row); // 你 可 以 用 echo($GLOBAL); 来 看 到 这 些 值 


} 
A 
$dbh - null; 
+ catch (PDOException $e) { 
die ("Error!: " . $e->getMessage() . "<br/>"), 


J 
// 默 认 这 个 不 是 长 连接 ， 如 果 需 要 数据 库 长 连接 ， 需 要 最 后 加 一 个 参数 : array (PDO: :ATTR PERSISTENT => true) 
$db = new PDO($dsn, $user, $pass, array(PDO::ATTR_PERSISTENT => true)), 


2» 
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很 简单 吧 ， 接 下 来 就 让 我 们 来 具体 看 下 PHP PDO 具 体 说 明 : 


o 


PDO: 


:beginTransaction 一 启动 一 个 事务 
commit 一 提交 一 个 事务 
. construct — 创建 一 个 表示 数据 库 连接 的 PDO 实例 
:errorCode — 获取 跟 数 据 库 句柄 上 一 次 操作 相关 的 SQLSTATE 
:errorlnfo 一 返回 最 后 一 次 操作 数据 库 的 错误 信息 
:exec 一 执行 一 条 SQL 语句 ， 并 返回 受 影响 的 行 数 
:getAttribute — 取 回 一 个 数据 库 连 接 的 属性 
:getAvailableDrivers 一 返回 一 个 可 用 驱动 的 数组 
:inTransaction 一 检查 是 否 在 一 个 事务 内 
:lastlnsertld 一 返回 最 后 插入 行 的 ID 或 序列 值 
“prepare 一 各 要 执行 的 SQL 语句 并 返回 一 个 PDOStatement 对 象 
“query 一 执行 SQL 语句 ， 返 回 PDOStatement 对 象 ,可 以 理解 为 结果 集 
:quote 一 为 SQL 语句 中 的 字符 串 添 加 引号 。 
:rollBack 一 回 滚 一 个 事务 
:setAttribute 一 设置 属性 


e PDOStatement X : 


o PDOStatement::bindColumn 一 绑 定 一 列 到 一 个 PHP FB 
o PDOStatement::bindParam — 绑 定 一 个 参数 到 指定 的 变量 名 
o PDOStatement::bindValue 一 把 一 个 值 绑 定 到 一 个 参数 


PDOStatement:: 
PDOStatement:: 
PDOStatement:: 
PDOStatement: 
PDOStatement:: 
PDOStatement:: 
PDOStatement: 
PDOStatement: 
PDOStatement: 
PDOStatement: 
PDOStatement:: 
PDOStatement:: 
PDOStatement:: 
PDOStatement: 
PDOStatement:: 
PDOStatement:: 


closeCursor 一 关闭 游标 ， 使 语句 能 再 次 被 执行 。 
columnCount — 返回 结果 集中 的 列 数 


debugDumpParams 一 打印 一 条 SQL 15 4 HB dn 4s 


:errorCode 一 获取 跟 上 一 次 语句 句柄 操作 相关 的 SOLSTATE 


errorlnfo 一 获取 跟 上 一 次 语句 句柄 操作 相关 的 扩展 错误 信息 
execute 一 执行 一 条 预 义理 语句 


‘fetch 一 从 结果 集中 获取 下 一 行 

:fetchAll 一 返回 一 个 包含 结果 集中 所 有 行 的 数组 
:fetchColumn 一 从 结果 集中 的 下 一 行 返回 单独 的 一 列 。 
:fetchObject 一 获取 下 一 行 并 作为 一 个 对 象 返回 。 


getAttribute 一 检索 一 个 语句 属性 
getColumnMeta 一 返回 结果 集中 一 列 的 元 数据 
nextRowset 一 在 一 个 多 行 集 语句 句柄 中 推进 到 下 一 个 行 集 


:rowCount 一 返回 受 上 一 个 SQL 语句 影响 的 行 数 


setAttribute 一 设置 一 个 语句 属性 
setFetchMode 一 为 语句 设置 默认 的 获取 模式 。 


PHP PDO 预 定义 常量 


以 下 常量 由 本 扩展 模块 定义 ， 因 此 只 有 在 本 扩展 的 模块 被 编译 到 PHP 中 ， 或 者 在 运行 时 被 动 
态 加 载 后 才 有 效 。 


2 
te: 


rh, 
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PDO:: 


PDO:: 


PDO:: 


PDO:: 


PDO:: 


PDO:: 
PDO:: 


PDO::PARAM BOOL (integer) 


PARAM NULL (integer) 
PARAM INT (integer) 
PARAM STR (integer) 
PARAM LOB (integer) 
PARAM STMT (integer) 


PARAM INPUT OUTPUT (integer) 


FETCH LAZY (integer) 


FETCH ASSOC (integer) 


FETCH NAMED (integer) 


FETCH NUM (integer) 
FETCH BOTH (integer) 
FETCH OBJ (integer) 


FETCH BOUND (integer) 
FETCH COLUMN (integer) 
FETCH CLASS (integer) 


FETCH INTO (integer) 

FETCH FUNC (integer) 
FETCH GROUP (integer) 
FETCH UNIQUE (integer) 
FETCH KEY PAIR (integer) 
FETCH CLASSTYPE (integer) 


PDO 使 用 类 常量 自 PHP 5.1。 以 前 的 版 本 使 用 的 全 局 常量 形式 PDO_PARAM_BOOL 


表示 SQL 中 的 NULL 数据 类 型 。 

表示 SQL 中 的 整 型 。 

表示 SQL 中 的 CHAR, VARCHAR 或 其 他 字 1 
表示 SQL 中 大 对 象 数据 类 型 。 

表示 一 个 记录 集 类 型 。 当 前 尚未 被 任何 驱动 支 
指定 参数 为 一 个 存储 过 程 的 INOUT 参数 。 必 : 


指定 获取 方式 ， 将 结果 集中 的 每 一 行 作为 一 个 
Zo Tt PDOStatement::fetchAll() 中 无 效 。 


指定 获取 方式 ， 将 对 应 结果 集中 的 每 一 行 作为 
PDO::FETCH_ASSOC 每 个 列 名 只 返回 一 个 值 


指定 获取 方式 ， 将 对 应 结果 集中 的 每 一 行 作为 
PDO::FETCH_ASSOC 每 个 列 名 返回 一 个 包 生 


指定 获取 方式 ， 将 对 应 结果 集中 的 每 一 行 作为 
取 方 式 ， 将 对 应 结果 集中 的 每 一 行 作为 
甘 取 方式 ， 将 结果 集中 的 每 一 行 作为 一 个 
获取 方式 ， 返回 TRUE AR RERA 
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甘 取 方式 ， 从 结果 集中 的 下 一 行 返 回 所 需 
获取 方式 ， 返 回 一 个 所 请 求 类 的 新 实例 ， 


ex 


ar mt 
REB At 


指定 获取 方式 ， 更 新 一 个 请 求 类 的 现 有 实例 ， 
人 允许 在 运行 中 完全 用 自 定义 的 方式 处 理 数据 。 
根据 值 分 组 返回 。 通 常 和 PDO::FETCH_COL 
只 取 唯 一 值 。 

获取 一 个 有 两 列 的 结果 集 到 一 个 数组 ， 其 中 第 
根据 第 一 列 的 值 确 定 类 名 。 


PDO::FETCH SERIALIZE (integer) 


PDO::FETCH_PROPS LATE (integer) 
PDO::ATTR_AUTOCOMMIT (integer) 


PDO::ATTR_PREFETCH (integer) 


PDO::ATTR_TIMEOUT (integer) 
PDO::ATTR_ERRMODE (integer) 


PDO-:ATTR SERVER VERSION 
(integer) 


PDO-ATTR CLIENT VERSION (integer) 
PDO-ATTR SERVER INFO (integer) 


PDOzZATTR CONNECTION STATUS 
(integer) 


PDO-ATTR CASE (integer) 
PDO:ATTR CURSOR NAME (integer) 


PDO::ATTR_CURSOR (integer) 


PDO:ATTR DRIVER NAME (string) 


PDO:ATTR ORACLE NULLS (integer) 
PDO::ATTR_PERSISTENT (integer) 


PDO-:ATTR STATEMENT CLASS 
(integer) 


PDO-:ATTR FETCH CATALOG NAMES 
(integer) 


PDO-:ATTR FETCH TABLE NAMES 
(integer) 


PDO::ATTR_STRINGIFY_FETCHES 
(integer) 


PDO::ATTR_MAX_COLUMN_LEN 
(integer) 


PDOzZATTR DEFAULT FETCH MODE 
(integer) 


PDO-:ATTR EMULATE PREPARES 
(integer) 


PDO:ERRMODE SILENT (integer) 


类 似 PDO::FETCH INTO, (AELI— 4 FE 814 
MOSES TS BUS FB. 


EBM AA Mise A PHP 5.2.0 起 可 
如 果 此 值 为 FALSE ，PDO 将 试图 禁用 自动 提 


设置 预 取 大 小 来 为 你 的 应 用 平衡 速度 和 内 存 使 
时 也 会 占用 更 多 的 内 存 。 


设置 连接 数据 库 的 超时 秒 数 。 
关于 此 属性 的 更 多 信息 请 参见 错误 及 错误 处 到 


此 为 只 读 属 性 ; 返回 PDO 所 连接 的 数据 库 服 : 


此 为 只 读 属 性 ; 返回 PDO 驱动 所 用 客户 端 库 
此 为 只 读 属 性 。 返 回 一 些 关 于 PDO 所 连接 的 


用 类 似 PDO::CASE * 的 常量 强制 列 名 为 指定 
获取 或 设置 使 用 游标 的 名 称 。 当 使 用 可 滚动 游 


选择 游标 类 型 。 PDO 当前 支持 PDO::CURSC 
确实 需要 一 个 可 滚动 游标 。 


返回 驱动 名 称 。 使 用 PDO:ATTR DRIVER N 
F : if ($db-&gt;getAttribute(PDO::ATTR DRIV 


在 获取 数据 时 将 空 字符 串 转 换 成 SOL 中 的 NU 
请 求 一 个 持久 连接 ， 而 非 创 建 一 个 新 连接 。 关 


将 包含 的 目录 名 添加 到 结果 集中 的 每 个 列 名 前 
支持 此 属性 。 


将 包含 的 表 名 添加 到 结果 集中 的 每 个 列 名 前 面 
此 属性 。 


自 PHP 5.2.0 起 可 用 。 


自 PHP 5.1.3 起 可 用 。 


如 果 发 生 错误 ， 则 不 显示 错误 或 异常 。 和 希望 开 


PDO:ERRMODE WARNING (integer) 如 果 发 生 错 误 ， 则 显示 一 个 PHP E_WARNIN， 
PDO:ERRMODE EXCEPTION (integer) 如 果 发 生 错 误 ， 则 抛 出 一 个 PDOException X 


PDO::CASE NATURAL (integer) 保留 数据 库 驱 动 返回 的 列 名 。 
PDO::CASE LOWER (integer) 强制 列 名 小 写 。 
PDO::CASE UPPER (integer) 强制 列 名 大 写 。 


PDO:NULL NATURAL (integer) 
PDO:NULL EMPTY STRING (integer) 
PDO:NULL TO STRING (integer) 


PDO:FETCH ORI NEXT (integer) 在 结果 集中 获取 下 一 行 。 仅 对 可 滚动 游标 有 效 
PDO:FETCH ORI PRIOR (integer) 在 结果 集中 获取 上 一 行 。 仅 对 可 滚动 游标 有 效 
PDO:FETCH ORI FIRST (integer) 在 结果 集中 获取 第 一 行 。 公 对 可 滚动 游标 有 效 
PDO::FETCH ORI LAST (integer) 在 结果 集中 获取 最 后 一 行 。 仅 对 可 滚动 游标 有 
PDO::FETCH ORI ABS (integer) 根据 行 号 从 结果 集中 获取 需要 的 行 。 仅 对 可 滚 
PDO::FETCH ORI REL (integer) 根据 当前 游标 位 置 的 相对 位 置 从 结果 集中 获取 
PDO::CURSOR_FWDONLY (integer) 创建 一 个 只 进 游标 的 PDOStatement 对 象 。 出 
PDO::CURSOR SCROLL (integer) 创建 一 个 可 滚动 游标 的 PDOStatement 对 象 。 


对 应 SOLSTATE '00000', z&z SQL 语句 没 在 


PEO ERR NENE EDITO) 否 有 错误 发 生 时 ， 此 常量 非常 方便 。 在 检查 上 


PDO::PARAM EVT ALLOC (integer) 分 配 事件 

PDO::PARAM EVT FREE (integer) 解除 分 配 事件 

人 AERE 执行 一 条 预 处 理 语句 之 前 触发 事件 。 

(integer) 

fi ARM ae QE 执行 一 条 预 处 理 语 名 之 后 触发 事件 。 

(integer) 

PDO one EPH RE 从 一 个 结果 集中 取出 一 条 结果 之 前 触发 事件 。 

(integer) 

cu ne S 从 一 个 结果 集中 取出 一 条 结果 之 后 触发 事件 。 
integer 


PDO::PARAM_EVT_NORMALIZE 


定 参 类 注 AN 5 15 Z [m] n jy A. < 
(integer) 在 绑 定 参数 注册 允许 驱动 程序 正常 化 变量 名 时 


PHP PDO ix 


连接 是 通过 创建 PDO 基 类 的 实例 而 建立 的 。 不 管 使 用 哪 种 驱动 程序 ， 都 是 用 PDO #4. 


连接 到 MySQL 


<?php 
$dbh = new PDO('mysql:host-localhost;dbname-test', $user, $pass), 
?> 


注意 : 如 果 有 任何 连接 错误 ， 将 抛 出 一 个 PDOException 异常 对 象 。 


处 理 连接 错误 


<?php 
try { 
$dbh = new PDO('mysql:host-localhost;dbname-test', $user, $pass), 
foreach($dbh->query('SELECT * from FOO") as $row) £ 
print r($row); 


J 
$dbh - null; 
+ catch (PDOException $e) { 


print "Error!: " . $e->getMessage() . "«br/»"; 
die(); 


连接 数据 成 功 后 ， 返 回 一 个 PDO 类 的 实例 给 脚本 ， 此 连接 在 PDO 对 象 的 生存 周期 中 保持 活 
动 。 

要 想 关 闭 连接 ， 需 要 销毁 对 象 以 确保 所 有 剩余 到 它 的 引用 都 被 删除 ， 可 以 赋 一 个 NULL 值 给 
TREE 


如 果 不 这 么 做 ，PHP 在 脚本 结束 时 会 自动 关闭 连接 。 
关闭 一 个 连接 : 


<?php 
$dbh = new PDO('mysql:host-localhost;dbname-test', $user, $pass), 
// 在 此 使 用 连接 


// 现在 运行 完成 ， 在 此 关闭 连接 


$dbh = null; 
?» 


很 多 web 应 用 程序 通过 使 用 到 数据 库 服 务 的 持久 连接 获得 好 处 。 


持久 连接 在 脚本 结束 后 不 会 被 关闭 ， 且 被 缓存 ， 当 另 一 个 使 用 相同 凭证 的 脚本 连接 请 求 时 被 
重用 。 


持久 连接 缓存 可 以 避免 每 次 脚本 需要 与 数据 库 回 话 时 建立 一 个 新 连接 的 开销 ， 从 而 让 web 应 
用 程序 更 快 。 


持久 化 连接 


<?php 
$dbh = new PDO('mysql:host-localhost;dbname-test', $user, $pass, array( 
PDO: :ATTR PERSISTENT => true 


)); 
?» 


注意 : 如 果 想 使 用 持久 连接 ， 必 须 在 传递 给 PDO ERRAI a t ŽI A RIE 
PDO::ATTR_PERSISTENT 。 如 果 是 在 对 象 初始 化 之 后 用 PDO::setAttribute() 设置 此 属性 ， 
则 驱动 程序 将 不 会 使 用 持久 连接 。 


PHP PDO 事务 与 自动 提交 


现在 通过 PDO 连接 上 了 ， 在 开始 进行 查询 前 ， 必 须 先 理解 PDO 是 如 何 管 理事 务 的 。 
事务 支持 四 大 特性 (ACID) : 


e 原子 性 (Atomicity) 
e 一 致 性 (Consistency) 
。 [sm (Isolation) 
e 持久 性 (Durability) 


通俗 地 讲 ， 在 一 个 事务 中 执行 的 任何 操作 ， 即 使 是 分 阶段 执行 的 ， 也 能 保证 安全 地 应 用 于 数 
据 库 ， 并 在 提交 时 不 会 受到 来 自 其 他 连接 的 干扰 。 


事务 操作 也 可 以 根据 请 求 自动 撤销 《假设 还 没有 提交 ) ， 这 使 得 在 脚本 中 义理 错误 更 加 容 
易 。 


事务 通常 是 通过 把 一 批 更 改 " 积 蓄 " 起 来 然后 使 之 同时 生效 而 实现 的 ; 这 样 做 的 好 处 是 可 以 大 大 
地 提供 这 些 更 改 的 效率 。 


换 名 话说， 事务 可 以 使 脚本 更 快 ， 而 且 可 能 更 健壮 (不 过 需要 正确 地 使 用 事务 才能 获得 这 样 
的 好 处 ) 。 


不 幸 的 是 ， 并 非 每 种 数据 库 都 支持 事务 ， 因 此 当 第 一 次 打开 连接 时 ，PDO 需要 在 所 谓 的 "自动 
提交 "模式 下 运行 。 


自动 提交 模式 意味 着 ， 如 果 数 据 库 支 持 ， 运 行 的 每 个 查询 都 有 它 自己 的 隐 式 事务 ， 如 果 数 据 
库 不 支持 事务 ， 则 没有 。 


如 果 需 要 一 个 事务 ， 则 必须 用 PDO::beginTransaction() 方法 来 启动 。 如 果 底 层 驱 动 不 支 持 事 
务 ， 则 抛 出 一 个 PDOException 异常 (不管 错误 处 理 设置 是 怎样 的 ， 这 都 是 一 个 严重 的 错误 
状态 ) 。 


一 旦 开始 了 事务 ， 可 用 PDO::commit() 或 PDO::rollBack() 来 完成 ， 这 取决 于 事务 中 的 代码 是 
否 运 行 成 功 。 


注意 : PDO 仅 在 驱动 层 检 查 是 否 具 有 事务 处 理 能 力 。 如 果 某 些 运行 时 条 件 意味 着 事务 不 可 
用 ， 且 数据 库 服务 接受 请 求 去 启动 一 个 事务 ，PDO::beginTransaction() 将 仍然 返回 TRUE 而 
且 没 有 错误 。 试 着 在 MySQL 数据 库 的 MyISAM 数据 表 中 使 用 事务 就 是 一 个 很 好 的 例子 。 


当 脚 本 结束 或 连接 即将 被 关闭 时 ， 如 果 尚 有 一 个 未 完成 的 事务 ， 那 么 PDO 将 自动 回 滚 该 事 
务 。 这 种 安全 措施 有 助 于 在 脚本 意外 终止 时 避免 出 现 不 一 致 的 情况 一 一 如 果 没 有 显 式 地 提交 
事务 ， 那 么 假设 是 某 个 地 方 出 错 了 ， 所 以 执行 回 滚 来 保证 数据 安全 。 





注意 : 只 有 通过 PDO::beginTransaction() 启动 一 个 事务 后 ， 才 可 能 发 生 自动 回 滚 。 如 果 手 动 
发 出 一 条 查询 启动 事务 ， 则 PDO 无 法 知晓 ， 从 而 在 必要 时 不 能 进行 回 滚 。 


在 事务 中 执行 批 处 理 : 


在 下 面 例 子 中 ， 假 设 为 新 员工 创建 一 组 条 目 ， 分 配 一 个 为 23 的 ID。 除 了 登记 此 人 的 基本 数据 
之 外 ， 还 需要 记录 他 的 工资 。 


两 个 更 新 分 别 完成 起 来 很 简单 ， 但 通过 封闭 在 PDO::beginTransaction() 和 PDO::commit() 调 
用 中 ， 可 以 保证 在 更 改 完成 之 前 ， 其 他 人 无 法 看 到 这 些 更 改 。 


如 果 发 生 了 错误 ，catch 块 回 滚 自 事务 启动 以 来 发 生 的 所 有 更 改 ， 并 输出 一 条 错误 信息 。 


<?php 
try { 
$dbh = new PDO('odbc:SAMPLE', "db2inst1", 'ibmdb2', 
array(PDO: :ATTR_PERSISTENT => true)); 
echo "Connected\n"; 
} catch (Exception $e) { 
die("Unable to connect: " . $e->getMessage()); 


J 


try € 
$dbh ->setAttribute(PDO: :ATTR ERRMODE, PDO: :ERRMODE EXCEPTION); 


$dbh->beginTransaction(); 
$dbh->exec("insert into staff (id, first, last) values (23, "Joe", 'Bloggs')"); 
$dbh->exec("insert into salarychange (id, amount, changedate) 
values (23, 50000, NOW())"); 
$dbh->commit(); 


} catch (Exception $e) { 


$dbh-»rollBack(); 
echo "Failed: " . $e-»getMessage(); 


并 不 局 限于 在 事务 中 更 改 ， 也 可 以 发 出 复杂 的 查询 来 提取 数据 ， 还 可 以 使 用 那些 信息 来 构建 
更 多 的 更 改 和 查询 ; 当 事 务 激 活 时 ， 可 以 保证 其 他 人 在 操作 进行 当中 无 法 作出 更 改 。 


PHP PDO 预 处 理 语 句 和 与 存储 过 程 


很 多 更 成 熟 的 数据 库 都 支持 预 处 理 语 句 的 概念 。 


什么 是 预 处 理 语句 ? 可 以 把 它 看 作 是 想 要 运行 的 SQL 的 一 种 编译 过 的 模板 ， 它 可 以 使 用 变量 
参数 进行 定制 。 预 处 理 语句 可 以 带 来 两 大 好 处 : 


e 查询 仅 需 解 析 (或 预 处 理 ) 一 次 ， 但 可 以 用 相同 或 不 同 的 参数 执行 多 次 。 当 查询 准备 好 
后 ， 数 据 库 将 分 析 、 编 译 和 优化 执行 该 查询 的 计划 。 对 于 复杂 的 查询 ， 此 过 程 要 花费 较 
长 的 时 间 ， 如 果 需 要 以 不 同 参 数 多 次 重复 相同 的 查询 ， 那 么 该 过 程 特 大 大 降低 应 用 程序 
的 速度 。 通 过 使 用 预 处 理 语句 ， 可 以 避免 重复 分 析 / 编 译 /优化 周期 。 简 言 之 ， 预 处 理 语 名 
占用 更 少 的 资源 ， 因 而 运行 得 更 快 。 

e 提供 给 预 处 理 语句 的 参数 不 需要 用 引号 括 起 来 ， 了 驱动 程序 会 自动 处 理 。 如 果 应 用 程序 只 
使 用 预 处 理 语句 ， 可 以 确保 不 会 发 生 SQL 注入 。 (然而 ， 如 果 查 询 的 其 他 部 分 是 由 未 转 
义 的 输入 来 构建 的 ， 则 仍 存 在 SQL 注入 的 风险 ) 。 


预 处 理 语句 如 此 有 用 ， 以 至 于 它们 唯一 的 特性 是 在 驱动 程序 不 支持 的 时 PDO 将 模拟 处 理 。 这 
样 可 以 确保 不 管 数据 库 是 否 具 有 这 样 的 功能 ， 都 可 以 确保 应 用 程序 可 以 用 相同 的 数据 访问 模 
式 。 


用 预 处 理 语句 进行 重复 插入 
下 面 例子 通过 用 name 和 value 替代 相应 的 命名 占 位 符 来 执行 一 个 插入 查询 


<?php 

$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)"), 
$stmt ->bindParam( " :name", $name); 

$stmt ->bindParam( " :value", $value); 


// 播 入 一 行 
$name = "one", 
$value - 1; 


$stmt->execute(); 


// ”用 不 同 的 值 插 入 另 一 行 


$name = "two", 
$value - 2; 
$stmt->execute(); 
?» 


用 预 处 理 语句 进行 重复 插入 


下 面 例子 通过 用 name 和 value 取代 ? 占 位 符 的 位 置 来 执行 一 条 插入 查询 。 


<?php 

$stmt = $dbh->prepare( "INSERT INTO REGISTRY (name, value) VALUES (?, ?)"); 
$stmt ->bindParam(1, $name); 

$stmt->bindParam(2, $value); 


// WA 
$name = "one", 
$value = 1; 


$stmt->execute(); 


// 用 不 同 的 值 插入 另 一 行 


$name = "two", 
$value - 2; 
$stmt->execute(); 
?» 
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下 面 例子 获取 数据 基于 键 值 已 提供 的 形式 。 用 户 的 输入 被 自动 用 引号 括 起 来 ， 因 此 不 会 有 
SQL 注入 攻击 的 危险 。 


<?php 
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?"); 
if ($stmt->execute(array($ GET['name']))) € 
while ($row - $stmt->fetch()) £ 
print r($row); 
} 
} 


2» 


如 果 数 据 库 驱动 支持 ， 应 用 程序 还 可 以 绑 定 输出 和 输入 参数 .输出 参数 通常 用 于 从 存储 过 程 获 
取 值 。 输 出 参数 使 用 起 来 比 输入 参数 要 稍微 复 条 一 些 ， 因 为 当 绑 定 一 个 输出 参数 时 ， 必 须知 
道 给 定 参数 的 长 度 。 如 果 为 参数 绑 定 的 值 大 于 建议 的 长 度 ， 就 会 产生 一 个 错误 。 


带 输出 参数 调用 存储 过 程 


<?php 
$stmt = $dbh->prepare("CALL sp returns string(?)"); 
$stmt ->bindParam(1, $return value, PDO::PARAM STR, 4000); 


// 调用 存储 过 程 
$stmt->execute(); 


print "procedure returned $return_value\n"; 
?> 


还 可 以 指定 同时 具有 输入 和 输出 值 的 参数 ， 其 语法 类 似 于 输出 参数 。 在 下 一 个 例子 中 ， 字 符 
串 "hello" 被 传递 给 存储 过 程 ， 当 存储 过 程 返回 时 ，hello 被 奉 换 为 该 存储 过 程 返回 的 值 。 


带 输入 /输出 人 参数 调用 存储 过 程 


<?php 

$stmt - $dbh->prepare( "CALL sp takes string returns string(?)"); 

$value - 'hello'; 

$stmt ->bindParam(1, $value, PDO::PARAM STR|PDO: : PARAM INPUT OUTPUT, 4000); 





// 调用 存储 过 程 
$stmt - >execute(), 


print "procedure returned $value\n"; 
?» 


占 位 符 的 无 效 使 用 


<?php 
$stmt = $dbh->prepare( "SELECT * FROM REGISTRY where name LIKE '%?%'"); 
$stmt ->execute(array($ GET['name'])); 


// 占 位 符 必须 被 用 在 整个 值 的 位 置 

$stmt = $dbh->prepare( "SELECT * FROM REGISTRY where name LIKE ?"), 
$stmt ->execute(array("%$_GET[name]%") ); 

?> 


PHP PDO 错误 与 错误 义理 


e PDO::ERRMODE_SILENT 


此 为 默认 模式 。 PDO 将 只 简单 地 设置 错误 码 ， 可 使 用 PDO::errorCode() 和 
PDO::errorlnfo() 方法 来 检查 语句 和 数据 库 对 象 。 如 果 错 误 是 由 于 对 语句 对 象 的 调用 而 产 
生 的 ， 那 么 可 以 调用 那个 对 象 的 PDOStatement::errorCode() 或 
PDOStatement::errorlnfo() 方法 。 如 果 错 误 是 由 于 调用 数据 库 对 象 而 产生 的 ， 那 么 可 以 
在 数据 库 对 象 上 调用 上 述 两 个 方法 。 


e PDO::ERRMODE WARNING 


除 设置 错误 码 之 外 ，PDO 还 将 发 出 一 条 传统 的 E_ WARNING 信息 。 如 果 只 是 想 看 看 发 
生 了 什么 问题 且 不 中 断 应 用 程序 的 流程 ， 那 么 此 设置 在 调试 /测试 期 间 非 常 有 用 。 

e PDO::ERRMODE EXCEPTION 
除 设 置 错误 码 之 外 ，PDO 还 将 抛 出 一 个 PDOException 异常 类 并 设置 它 的 属性 来 反射 错 
误 码 和 错误 信息 。 此 设置 在 调试 期 间 也 非常 有 用 ， 因 为 它 会 有 效 地 放大 脚本 中 产生 错误 
的 点 ， 从 而 可 以 非常 快速 地 指出 代码 中 有 问题 的 潜在 区 域 Gef: 如 果 异 常 导致 脚本 终 
止 ， 则 事务 被 自动 回 滚 ) 。 


异常 模式 另 一 个 非常 有 用 的 是 ， 相 比 传统 PHP 风格 的 警告 ， 可 以 更 清晰 地 构建 自己 的 错 
误 处 理 ， 而 且 比 起 静默 模式 和 显 式 地 检查 每 种 数据 库 调 用 的 返回 值 ， 异 常 模式 需要 的 代 
ORE AY, 


创建 PDO 实例 并 设置 错误 模式 


<?php 

$dsn = 'mysql:dbname-testdb;host-127.0.0.1'; 
$user = 'dbuser'; 

$password - 'dbpass'; 

try ( 


$dbh = new PDO($dsn, $user, $password), 
$dbh ->setAttribute(PDO: :ATTR ERRMODE, PDO::ERRMODE EXCEPTION); 
+ catch (PDOException $e) { 


echo "Connection failed: ' . $e->getMessage(); 
J 
?> 
注意 : 不 管 当前 是 否 设置 了 PDO::ATTR_ERRMODE ， 如 果 连 接 失 败 ，PDO:: construct() 
将 总 是 抛 出 一 个 PDOException 异常 。 未 捕获 异常 是 致命 的 。 


创建 PDO 实例 并 在 构造 画 数 中 设置 错误 模式 


<?php 

$dsn - 'mysql:dbname-test;host-127.0.0.1'; 
$user - 'googleguy'; 

$password - 'googleguy'; 


As 
使 用 try/catch 围绕 构造 画 数 仍然 有 效 ， 即 使 设置 了 ERRMODE 为 WARNING, 
因为 如 果 连 接 失败 ，PD0O:: Construct 将 总 是 抛 出 一 个 PDOException 异常 。 
wf 
try { 


$dbh = new PDO($dsn, $user, $password, array(PDO::ATTR_ERRMODE => PDO: :ERRMODE WARNIN 
+ catch (PDOException $e) { 

echo "Connection failed: ' . $e-»getMessage(); 

exit; 


J 


// 这 里 将 导致 PDO 抛 出 一 个 E WARNING 级 别 的 错误 ， 而 不 是 一 个 异常 〈 当 数据 表 不 存在 时 ) 
$dbh->guery( "SELECT wrongcolumn FROM wrongtable"); 
?> 


EE 
以 上 例 程 会 输出 : 





Warning: PDO::query(): SQLSTATE[42S02]: Base table or view not found: 1146 Table 'test.wr 
/tmp/pdo test.php on line 18 
add a note add a note 


| See 





e] 


PHP PDO X1 £& (LOBs) 


应 用 程序 在 某 一 时 刻 ， 可 能 需要 在 数据 库 中 存储 "大 "数据 。 


"大 "通常 意味 着 "大 约 4kb 或 以 上 "， 尽 管 某 些 数据 库 在 数据 达到 "大 "之 前 可 以 轻松 地 处 理 多 达 
32kb 的 数据 。 大 对 象 本 质 上 可 能 是 文本 或 二 进 制 。 


f£ PDOStatement::bindParam() 或 PDOStatement::bindColumn()) 调用 中 使 用 
PDO::PARAM LOB 类 型 码 可 以 让 PDO 使 用 大 数据 类 型 。 


PDO::PARAM_LOB 告诉 PDO 作为 流 来 映射 数据 ， 以 便 能 使 用 PHP Streams API 来 操作 。 


从 数据 库 中 显示 一 张 图 片 


下 面 例子 绑 定 一 个 LOB 到 Slob 变量 ， 然 后 用 fpassthru() 将 其 发 送 到 浏览 器 。 因 为 LOB 代表 
一 个 流 ， 所 以 类 似 fgets()、fread() 以 及 stream get contents() 这 桩 的 函数 都 可 以 用 在 它 上 
面 。 


<?php 

$db = new PDO( "odbc:SAMPLE", 'db2insti', "ibmdb2"), 

$stmt - $db->prepare("select contenttype, imagedata from images where id-?"); 
$stmt ->execute(array($ GET['id'])); 

$stmt->bindColumn(1, $type, PDO: :PARAM STR, 256), 

$stmt ->bindColumn(2, $lob, PDO::PARAM LOB); 

$stmt->fetch(PDO: :FETCH BOUND); 


header( "Content -Type: $type"); 


fpassthru($lob), 
?> 


插入 一 张 图 片 到 数据 库 


下 面 例子 打开 一 个 文件 并 将 文件 句柄 传 给 PDO 来 做 为 一 个 LOB 插入 。PDO 尽 可 能 地 让 数据 
库 以 最 有 效 的 方式 获取 文件 内 容 。 


<?php 

$db = new PDO( "odbc:SAMPLE", 'db2insti', "ibmdb2"), 

$stmt = $db->prepare( "insert into images (id, contenttype, imagedata) values (?, ?, ?)"); 
$id = get new id(); // 调用 某 个 函数 来 分 配 一 个 新 ID 


// 假设 处 理 一 个 文件 上 传 
// 可 以 在 PHP 文档 中 找到 更 多 的 信息 


$fp = fopen($ FILES['file']['tmp name'], 'rb'); 


$stmt ->bindParam(1, $id); 
$stmt ->bindParam(2, $ FILES['file']['type']); 
$stmt ->bindParam(3, $fp, PDO::PARAM LOB); 


$db->beginTransaction(); 
$stmt->execute(); 
$db->commit(); 

?» 


| 
插入 一 张 图 片 到 数据 库 : Oracle 


对 于 从 文件 插入 一 个 lob，Oracle 略 有 不 同 。 必 须 在 事务 之 后 进行 插入 ， 否 则 当 执 行 查询 时 导 
致 新 近 插 入 LOB 将 以 0 长 度 被 隐 式 提交 : 


<?php 

$db = new PDO('oci:', "scott", 'tiger'); 

$stmt - $db->prepare("insert into images (id, contenttype, imagedata) " . 
"VALUES (?, ?, EMPTY BLOB()) RETURNING imagedata INTO ?"): 

$id = get new id(); // 调用 某 个 函数 来 分 配 一 个 新 ID 


// 假设 处 理 一 个 文件 上 传 
// 可 以 在 PHP 文档 中 找到 更 多 的 信息 


$fp = fopen($ FILES['file']['tmp name'], 'rb'); 


$stmt ->bindParam(1, $id), 
$stmt ->bindParam(2, $ FILES['file']['type']); 
$stmt ->bindParam(3, $fp, PDO::PARAM LOB); 


$stmt ->beginTransaction(), 
$stmt - >execute(), 
$stmt->commit(); 

?> 


PDO::beginTransaction 


PDO::beginTransaction £ z; — ĎE 4- (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
DL AR 
语法 

bool PDO::beginTransaction ( void ) 


关闭 自动 提交 模式 。 自 动 提交 模式 被 关闭 的 同时 ， 通 过 PDO 对 象 实例 对 数据 库 做 出 的 更 改 直 
到 调用 PDO::commit() 结束 事务 才 被 提交 。 
调用 PDO::rollBack() 将 回 滚 对 数据 库 做 出 的 更 改 并 将 数据 库 连 接 返回 到 自动 提交 模式 。 


包括 MySQL 在 内 的 一 些 数据 库 ， 当 发 出 一 条 类 似 DROP TABLE 或 CREATE TABLE 这 样 的 
DDL 语句 时 ， 会 自动 进行 一 个 隐 式 地 事务 提交 。 


隐 式 地 提交 将 阻止 你 在 此 事务 范围 内 回 滚 任何 其 他 更 改 。 


3 [B] f 


成 功 时 返回 TRUE, 或 者 在 失败 时 返回 FALSE, 


实例 


回 滚 一 个 事务 
下 面 例子 在 回 滚 此 更 改 前 开始 一 个 事务 并 发 出 两 条 修改 数据 库 的 语句 。 
但 在 MySQL +, DROP TABLE 语句 自动 提交 事务 ， 使 得 在 此 事务 中 的 任何 更 改 都 不 会 被 回 


N^ 
Ro 


<?php 
/* 开始 一 个 事务 ， 关 闭 自动 提交 */ 


$dbh->beginTransaction(); 


/* ”更 改 数据 库 架 构 及 数据 */ 
$sth = $dbh->exec("DROP TABLE fruit"); 
$sth = $dbh->exec("UPDATE dessert 

SET name = 'hamburger'"); 


/* 识别 出 错误 并 回 滚 更 改 “/ 
$dbh-»rollBack(); 


/* 数据 库 连接 现在 返回 到 自动 提交 模式 */ 
?> 


PDO::commit 


PDO::commit 提 交 一 个 事务 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
DL AR 
语法 

bool PDO::commit ( void ) 


是 交 一 个 事务 ， 数 据 库 连 接 返 回 到 自动 提交 模式 直到 下 次 调用 PDO:beginTransaction() 开始 
一 个 新 的 事务 为 止 。 


返回 值 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


实例 


提交 一 个 基础 事务 


<?php 
/* 开始 一 个 事务 ， 关 闭 自动 提交 */ 


$dbh->beginTransaction(); 


/* 在 全 有 或 全 无 的 基础 上 插入 多 行 记录 〈 要 么 全 部 插入 ， 要 么 全 部 不 插入 ) */ 
$sgl = "INSERT INTO fruit 

(name, colour, calories) 

VALUES (?, ?, ?)'; 


$sth = $dbh-»prepare($sq1); 


foreach ($fruits as $fruit) { 
$sth->execute(array( 
$fruit-»name, 
$fruit-»colour, 
$fruit-»calories, 
)): 
J 


/* 提交 更 改 */ 
$dbh-»commit(); 


/* 现在 数据 库 连 接 返回 到 自动 提交 模式 */ 


?> 


提交 一 个 DDL 事 务 


<?php 
/* ”开始 一 个 事务 ， 关 闭 自动 提交 */ 
$dbh->beginTransaction(); 


/* Change the database schema */ 
$sth = $dbh->exec("DROP TABLE fruit"); 


/* 更 改 数据 库 架构 */ 
$dbh - >commit (), 


/* 现在 数据 库 连 接 返回 到 自动 提交 模式 */ 
2» 


注意 : 并 不 是 所 有 数据 库 都 允许 使 用 DDL 语 句 进 行事 务 操作 : 有 些 会 产生 错误 ， 
(包括 MySQL) 会 在 遇 到 第 一 个 DDL 语 句 后 就 自动 提交 事务 。 


PDO:: construct 


PDO:: construct 一 创建 一 个 表示 数据 库 连 接 的 PDO 实例 (PHP 5 >= 5.1.0, PECL pdo >= 
0.1.0) 


PDO:: construct ( string $dsn [, string $username [, string $password [, array $driver o 
EE] 
创建 一 个 表示 连接 到 请 求 数据 库 的 数据 库 连 接 PDO 实例 。 





参数 说 明 


e dsn : 数据 源 名 称 或 叫做 DSN， 包 含 了 请 求 连 接 到 数据 库 的 信息 。 

e username : DSN 字 符 串 中 的 用 户 名 。 对 于 某 些 PDO 驱 动 ， 此 参数 为 可 选项 。 
e password: DSN 字 符 串 中 的 密码 。 对 于 某 些 PDO 驱 动 ， 此 参数 为 可 选项 。 
e driver options : 一 个 具体 驱动 的 连接 选项 的 键 => 值 数组 。 


VR [n] (à 
成 功 则 返回 一 个 PDO 对 象 。 
错误 异常 


如 果 试 图 连接 到 请 求 的 数据 库 失 败 ， 则 PDO::”construct() 抛 出 一 个 PPOR 
(PDOException) . 


实例 


通过 调用 驱动 程序 创建 一 个 PDO 实 例 


<?php 

/* 通过 调用 驱动 程序 创建 一 个 PDO 实 例 */ 

$dsn = 'mysql:dbname-testdb;host-127.0.0.1'; 
$user = 'dbuser'; 

$password = 'dbpass'; 


try ( 

$dbh = new PDO($dsn, $user, $password); 
+ catch (PDOException $e) { 

echo "Connection failed: ' . $e->getMessage(); 
} 


2> 


PDO::errorCode 


PDO::errorCode 一 获取 跟 数据 库 句 柄 上 一 次 操作 相关 的 SOLSTATE (PHP 5 >= 5.1.0, PECL 
pdo >= 0.1.0) 


说 明 
语法 


mixed PDO: :errorCode ( void ) 


3 [B] f 


返回 一 个 SQLSTATE， 一 个 由 5 个 字母 或 数字 组 成 的 在 ANSI SQL 标准 中 定义 的 标识 符 。 简 
要 地 说 ， 一 个 SQLSTATE 由 前 面 两 个 字符 的 类 值 和 后 面 三 个 字符 的 子 类 值 组 成 。 


如 果 数 据 库 句柄 没有 进行 操作 ， 则 返回 NULL. 


例 


取得 一 个 SQLSTATE 码 


将 


/* 引发 一 个 错误 -- BONES 数据 表 不 存在 */ 
$dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')"); 


echo "XnPDO::errorCode(): " 
print $dbh--errorCode( ); 
?> 


以 上 例 程 会 输出 : 


PDO::errorCode(): 42502 


PDO::errorlnfo 


PDO::errorCode — 返回 最 后 一 次 操作 数据 库 的 错误 信息 (PHP 5 >= 5.1.0, PECL pdo >= 
0.1.0) 


说 明 
语法 


public array PDO::errorInfo ( void ) 


3 [B] f 


返回 一 个 数组 ， 该 数组 包含 了 最 后 一 次 操作 数据 库 的 错误 信息 描述 。 


数组 内 容 如 下 : 
元 素 信息 
0 SQLSTATE 错误 码 (5 个 字母 或 数字 组 成 的 在 ANSI SQL 标准 中 定义 的 标识 符 ). 
1 错误 代码 
2 úl A 


注意 : 如 果 数 据 库 句柄 没有 进行 操作 ， 则 返回 NULL 。 


例 


显示 errorlnfo() 中 关于 PDO_ODBC 连 接 到 DB2 数 据 库 的 错误 信 
息 


将 


<?ph 
/* 错误 的 SQL 语法 */ 
$stmt = $dbh->prepare('bogus sql'); 
if (!$stmt) { 
echo "\nPDO::erroriInfo():\n"; 
print r($dbh-»errorInfo()); 


以 上 例 程 会 输出 : 


PDO: :errorInfo(): 
Array 


[0] => Hy000 
[1] => 1 
[2] => near "bogus": syntax error 


PDO::exec 


PDO::exec 一 执行 一 条 SOL 语句 ， 并 返回 受 影 响 的 行 数 (PHP 5 >= 5.1.0, PECL pdo >= 
0.1.0) 
说 明 
语法 
int PDO::exec ( string $statement ) 


PDO::exec() 在 一 个 单独 的 函数 调用 中 执行 一 条 SAL 语句 ， 返 回 受 此 语句 影响 的 行 数 。 
PDO::exec() 不 会 从 一 条 SELECT 语句 中 返回 结果 。 对 于 在 程序 中 只 需要 发 出 一 次 的 
SELECT 语句 ， 可 以 考虑 使 用 PDO::query()。 

参数 说 明 : 


statement: 要 被 预 处 理 和 执行 的 SQL 语句 。 


RIE) f 


PDO::exec() 


IR 
PDO::exec() 3x 


回 受 修改 或 删除 SQL 语句 影响 的 行 数 。 如 果 没 有 受 影响 的 行 ， 则 
回 0. 


下 面 例子 依赖 PDO::exec() 的 返回 值 是 不 正确 的 ， 其 中 受 影响 行 数 为 0 的 语句 会 导致 调用 
die() : 


<?php 
$db->exec() or die(print r($db->errorInfo(), true)); 
?> 


例 


执行 一 条 DELETE 语句 


将 


计算 由 一 条 不 带 WHERE 字句 的 DELETE 语句 删除 的 行 数 。 


<?php 
$dbh = new PDO("odbc: sample", 'db2insti', 'ibmdb2'); 


/* WIR FRUIT 数据 表 中 满足 条 件 的 所 有 行 “/ 
$count = $dbh->exec("DELETE FROM fruit WHERE colour = "red""), 


/* 返回 被 删除 的 行 数 */ 
print("Deleted $count rows.\n"); 
?> 


以 上 例 程 会 输出 : 


Deleted 1 rows . 


PDO::getAttribute 


PDO ::getAttribute 一 取 回 一 个 数据 库 连 接 的 属性 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 

mixed PDO: :getAttribute ( int $attribute ) 


TER (757A) 返回 一 个 数据 库 连 接 的 属性 值 。 取 回 PDOStatement 属性 ， 请 参阅 
PDOStatement::getAttribute()。 


注意 有 些 数据 库 /驱动 可 能 不 支持 所 有 的 数据 库 连 接 属性 。 


参数 说 明 : 
attribute : PDO::ATTR_* 常量 中 的 一 个 。 下 列 为 应 用 到 数据 库 连 接 中 的 常量 : 


e PDO:ATTR AUTOCOMMIT 

e PDO:ATTR CASE 

e PDO:ATTR CLIENT VERSION 
e PDO:ATTR CONNECTION STATUS 
e PDO:ATTR DRIVER NAME 

e PDO:ATTR ERRMODE 

e PDO:ATTR ORACLE NULLS 

e PDO:ATTR PERSISTENT 

e PDO:ATTR PREFETCH 

e PDO:ATTR SERVER INFO 

e PDO:ATTR SERVER VERSION 
e PDO::ATTR_TIMEOUT 


j& [n] fe 


成 功 调用 则 返回 请 求 的 PDO 属性 值 。 不 成 功 则 返回 null. 


实例 


取 回 数据 库 连接 属性 


<?php 

$conn = new PDO('odbc:sample', "db2inst1", 'ibmdb2'); 

$attributes - array( 
"AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT VERSION", "CONNECTION STATUS", 
"ORACLE NULLS", "PERSISTENT", "PREFETCH", "SERVER INFO", "SERVER VERSION", 
"TIMEOUT" 


Ne 


foreach ($attributes as $val) { 
echo "PDO: :ATTR_$val: "; 
echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "n"; 


PDO::getAvailableDrivers 


PDO::getAvailableDrivers — 返回 一 个 可 用 驱动 的 数组 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
DL AR 
语法 

static array PDO::getAvailableDrivers ( void ) 


array pdo drivers ( void ) 


ea (753A) 返回 所 有 当前 可 用 在 PDO:: construct() 的 参数 DSN 中 的 PDO 驱动 。 


返回 值 


PDO::getAvailableDrivers() 返回 一 个 包含 可 用 PDO 驱动 名 字 的 数组 。 如 果 没 有 可 用 的 驱 
动 ， 则 返回 一 个 空 数 组 。 


例 
一 个 PDO::getAvailableDrivers() 的 例子 


将 


<?php 
print r(PDO::getAvailableDrivers()); 
?> 


以 上 例 程 的 输出 类 似 于 : 


Array 
( 
[0] => mysql 
[1] => sqlite 
) 


PDO::inTransaction 


PDO::inTransaction 一 检查 是 否 在 一 个 事务 内 (PHP 5 >= 5.3.3, Bundled pdo pgsql) 
说 明 
语法 

bool PDO::inTransaction ( void ) 


检查 驱动 内 的 一 个 事务 当前 是 否 久 于 激活 。 此 方法 仅 对 支持 事务 的 数据 库 驱 动 起 作用 。 


参数 


3 [E] f 


如 果 当 前 事务 处 于 激活 ， 则 返回 TRUE, BN RIE] FALSE. 


PDO::lastlnsertld 


PDO::lastInsertld 一 返回 最 后 插入 行 的 ID 或 序列 值 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 

string PDO::lastInsertId ([ string $name = NULL ] ) 


返回 最 后 插入 行 的 ID， 或 者 是 一 个 序列 对 象 最 后 的 值 ， 取 决 于 底层 的 驱动 。 比 如 ， 
PDO PGSQL() 要 求 为 name 参数 指定 序列 对 象 的 名 称 。 


注意 : 在 不 同 的 PDO 驱动 之 间 ， 此 方法 可 能 不 会 返回 一 个 有 意义 或 一 致 的 结果 ， 因 为 底层 
数据 库 可 能 不 支持 自 增 字段 或 序列 的 概念 。 


参数 


name 应 该 返回 ID 的 那个 序列 对 象 的 名 称 。 


jx [n] (4. 
如 果 没 有 为 参数 name 指定 序列 名 称 ，PDO::lastlnsertld() 则 返回 一 个 表示 最 后 插入 数据 库 那 
一 行 的 行 ID 的 字符 串 。 


如 果 为 参数 name 指定 了 序列 名 称 ，PDO::lastlnsertld() 则 返回 一 个 表示 从 指定 序列 对 象 取 回 
最 后 的 值 的 字符 串 。 


如 果 当 前 PDO 驱动 不 支持 此 功能 ， 则 PDO::lastinsertld() 触发 一 个 IM001 SQLSTATE 。 


PDO::prepare 


PDO::prepare 一 准备 要 执行 的 SQL 语句 并 返回 一 个 PDOStatement si KR (PHP 5 >= 5.1.0, 
PECL pdo >= 0.1.0) 


说 明 


public PDOStatement PDO::prepare ( string $statement [, array $driver options = array() ] 
[5| ca ne ——R-——— À——— À————] 


为 PDOStatement::execute() FAKES S 44 189SQLi2 6], SQL;S JST EAGLE SS 9X de PÁ 
名 (name) 或 问号 (0) 参数 标记 ， 参 数 在 SQL 执行 时 会 被 蔡 换 。 





你 不 能 在 SQL 语句 中 同时 包含 命名 (name) 或 问号 (?) 参数 标记 ， 只 能 选择 其 中 一 种 风 
格 。 


A 
er 
ri 


预 处 理 SQL 语句 中 的 参数 在 使 用 PDOStatement::execute() 方 法 时 会 传递 真 $ 


参数 


statement 合法 的 SQL 语句 。 


driver options 此 数组 包含 一 个 或 多 个 key=>value 对 来 设置 PDOStatement 对 象 的 属性 ， 
最 常 使 用 到 是 将 PDO::ATTR_CURSOR 值 设置 为 PDO::CURSOR_SCROLL 来 请 求 一 个 可 滚动 
游标 。 


3 [B] (A 


如 果 成 功 ，PDO::prepare() 返 回 PDOStatement 对 象 ， 如 果 失 败 返 回 FALSE 或 抛 出 异常 
PDOException + 


实例 


使 用 命名 (name) 参数 来 准备 SQL 语句 


<?php 


/* 通过 数组 值 向 预 处 理 语句 传递 值 */ 


$sgl = "SELECT name, colour, calories 
FROM fruit 
WHERE calories « :calories AND colour - :colour'; 


$sth = $dbh->prepare($sgl, array(PDO::ATTR CURSOR => PDO: :CURSOR FWDONLY)); 
$sth->execute(array(':calories' => 150, ':colour' => 'red')); 

$red = $sth->fetchAll(); 

$sth->execute(array(':calories' => 175, ':colour' => 'yellow')); 

$yellow = $sth->fetchAll(); 

?> 


使 用 问号 0) 参数 来 准备 SQL 语句 


<?php 

/* 通过 数组 值 向 预 处 理 语 名 传递 值 */ 

$sth = $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ?"), 

$sth->execute(array(150, 'red')); 

$red = $sth->fetchAll(); 

$sth->execute(array(175, 'yellow')); 

$yellow = $sth->fetchAll(); 

?> 


PDO::guery 


PDO::guery 一 执行 SQL 语句 ， 返 回 PDOStatement 对 象 ,可 以 理解 为 结果 集 (PHP 5 >= 5.1.0, 
PECL pdo >= 0.2.0) 


说 明 
语法 


public PDOStatement PDO::query ( string $statement ) 


public PDOStatement PDO::query ( string $statement , int $PDO::FETCH_COLUMN , int $colno 





PDO::query() 在 一 个 单独 的 函数 中 调用 并 执行 SQL 语句 , 返回 结果 集 (如 果 有 ), 语 句 作 为 一 个 
PDOStatement 对 象 返 回 。 


参数 


statement 要 执行 的 SQL 语句 。 


返回 值 


如 果 成 功 ，PDO::query() 返 回 PDOStatement 对 象 ， 如 果 失 败 返 回 FALSE 。 


实例 
PDO::query 实 例 


<?php 

function getFruit($conn) £ 
$sql - "SELECT name, color, calories FROM fruit ORDER BY name", 
foreach ($conn->guery($sgl) as $row) ( 


print $row['name'] . "Nt"; 
print $row['color'] . "Nt"; 
print $row['calories'] . "\n"; 
H 
} 
?> 
以 上 输出 结果 为 : 

apple red 150 

banana yellow 250 

kiwi brown 75 


lemon yellow 25 
orange orange 300 
pear green 150 
watermelon pink 90 


PDO::guote 


PDO::quote 一 为 SQL 语句 中 的 字符 串 添加 引号 。(PHP 5 >= 5.1.0, PECL pdo >= 0.2.1) 
说 明 
> 

public string PDO::guote ( string $string [, int $parameter type - PDO::PARAM STR ] ) 


PDO::quote() 为 SQL 语句 中 的 字符 串 添 加 引号 或 者 转 义 特殊 字符 串 。 


BB 

string 要 添加 引号 的 字符 串 。 

parameter type 为 驱动 程序 提供 数据 类 型 。 
VR [B] f& 


返回 一 个 带 引 号 的 字符 串 ， 理 论 上 可 以 安全 的 传递 到 SQL 语句 中 并 执行 。 如 果 该 驱动 程序 不 
支持 则 返回 FALSE。 


实例 


为 普通 字符 串 添 加 引号 


<?php 
$conn = new PDO('sqlite:/home/lynn/music.sql3'); 


/* Simple string */ 


$string - 'Nice'; 
print "Unquoted string: $string\n"; 
print "Quoted string: " . $conn->guote($string) . "^n"; 
?> 
以 上 输出 结果 为 : 


Unguoted string: Nice 
Ouoted string: "Nice! 


转 义 特殊 字符 串 


<?php 
$conn = new PDO("sglite:/home/lynn/music. sg13"), 


/* Dangerous string */ 

$string = "Naughty X" string", 

print "Unquoted string: $string\n"; 

print "Quoted string:" . $conn->guote($string) . "^n"; 
?> 


以 上 例 程 会 输出 : 


Unguoted string: Naughty " string 
Quoted string: "Naughty '' string! 


PDO::rollBack 


PDO::rollBack 一 回 滚 一 个 事务 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 

bool PDO::rollBack ( void ) 


Eà FA PDO::beginTransaction() 发 起 的 当前 事务 。 如 果 没 有 事务 激活 ， 将 抛 出 一 个 
PDOException 异常 。 


如 果 数 据 库 被 设置 成 自动 提交 模式 ， 此 画 数 (方法) 在 回 滚 事务 之 后 将 恢复 自动 提交 模式 。 


包括 MySQL 在 内 的 一 些 数据 库 ， 当 在 一 个 事务 内 有 类 似 删 除 或 创建 数据 表 等 DLL 语句 时 ， 
会 自动 导致 一 个 隐 式 地 提交 。 隐 式 地 提交 将 无 法 回 滚 此 事务 范围 内 的 任何 更 改 。 


退回 值 

成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 
例 

回 滚 一 个 事务 


下 面 例子 在 回 滚 更 改 之 前 开始 一 个 事务 并 发 出 两 条 修改 数据 库 的 语句 。 但 在 MySQL m, 
DROP TABLE 语句 自动 提交 事务 ， 因 此 在 此 事务 内 的 任何 更 改 都 不 会 被 回 滚 。 


将 


<?ph 
/* 开始 一 个 事务 ， 关 闭 自动 提交 */ 


$dbh->beginTransaction(); 


/* 更 改 数据 库 架 构 和 数据 */ 
$sth = $dbh->exec("DROP TABLE fruit"); 
$sth = $dbh->exec("UPDATE dessert 

SET name = 'hamburger'"); 


/* iRS|BUXBIBURSR */ 
$dbh->rollBack(); 


/* ”此 时 数据 库 连 接 恢复 到 自动 提交 模式 */ 


2» 
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PDO::setAttribute 


PDO::setAttribute — 设置 属性 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 
bool PDO::setAttribute ( int $attribute , mixed $value ) 
设置 数据 库 句柄 属性 。 下 面 列 出 了 一 些 可 用 的 通用 属性 ; 有 些 驱动 可 能 使 用 另外 的 特定 属 
性 。 
。 PDO-ATTR CASE : 强制 列 名 为 指定 的 大 小 写 。 
o PDO::CASE LOWER : 强制 列 名 小 写 。 
o PDO::CASE_NATURAL : 保留 数据 库 驱 动 返回 的 列 名 。 
o PDO::CASE UPPER : 强制 列 名 大 写 。 
e PDO::ATTR_ERRMODE : 错误 报告 。 
o PDO::ERRMODE_SILENT : 仅 设置 错误 代码 。 
o PDO::ERRMODE_WARNING: 引发 E WARNING 错误 


o PDO:ERRMODE EXCEPTION: 抛 出 exceptions 异常 。 


e PDO::ATTR_ORACLE_NULLS (在 所 有 了 驱动 中 都 可 用 ， 不 仅 限于 Oracle) : 转换 
NULL 和 空 字 符 串 。 


o PDO::NULL NATURAL: 不 转换 。 
o PDO:NULL EMPTY STRING : 将 空 字 符 串 转换 成 NULL o 
o PDO::NULL TO STRING: 将 NULL 转换 成 空 字符 串 。 
e PDO:ATTR STRINGIFY FETCHES: 提取 的 时 候 将 数值 转换 为 字符 串 。 需要 bool. 


e PDO:ATTR STATEMENT. CLASS : 设置 从 PDOStatement 派 生 的 用 户 提供 的 语句 类 。 
不 能 用 于 持久 的 PDO 实 例 。 需要 array(string 类 名 , array(mixed 构造 画 数 的 参数 ))。 


e PDO:ATTR TIMEOUT : 指定 超时 的 秒 数 。 并 非 所 有 驱动 都 支持 此 选项 ， 这 意味 着 驱动 
和 驱动 之 间 可 能 会 有 差异 。 比 如 ，SQLite 等 待 的 时 间 达 到 此 值 后 就 放 奔 获取 可 写 锁 ， 但 
其 他 驱动 可 能 会 将 此 值 解 释 为 一 个 连接 或 读 取 超 时 的 间隔 。 需要 int 类 型 。 


Kr 


e PDO:ATTR AUTOCOMMIT (1£OCI, Firebird 以 及 MySQL 中 可 用 ) : 是 否 自动 提 
每 个 单独 的 语句 。 


e PDO:ATTR EMULATE PREPARES 启用 或 禁用 预 处 理 语句 的 模拟 。 有 些 驱动 不 支持 
或 有 限度 地 支持 本 地 预 处 理 。 使 用 此 设置 强制 PDO 总 是 模拟 预 处 理 语句 〈 如 果 为 TRUE 
) ， 或 试 着 使 用 本 地 预 处 理 语 句 (如 果 为 ”FALsE ) 。 如 果 驱 动 不 能 成 功 预 处 理 当前 查 
询 ， 它 将 总 是 回 到 模拟 预 处理 语 名 上。 需要 bool 类 型 。 


e PDO:MYSQL ATTR USE BUFFERED QUERY (在 MySQL 中 可 用 ) : 使 用 缓冲 查 
询 。 


e PDO:ATTR DEFAULT FETCH MODE : 设置 默认 的 提取 模式 。 关 于 模式 的 说 明 可 以 在 
PDOStatement::fetch() 文档 找到 。 


返回 值 


成 功 时 返回 TRUE, 或 者 在 失败 时 返回 FALSE, 


PDOStatement::bindColumn 


PDOStatement::bindColumn 一 绑 定 一 列 到 一 个 PHP & &(PHP 5 >= 5.1.0, PECL pdo >= 
0.1.0) 


说 明 
语法 


bool PDOStatement: :bindColumn ( mixed $column , mixed &$param [, int $type [, int $maxlen 
EE) 


安排 一 个 特定 的 变量 绑 定 到 一 个 查询 结果 集中 给 定 的 列 。 每 次 调用 PDOStatement::fetch() 或 
PDOStatement::fetchAll() 都 将 更 新 所 有 绑 定 到 列 的 变量 。 





注意 : 在 语句 执行 前 PDO 有 关 列 的 信息 并 非 总 是 可 用 ， 可 移植 的 应 用 应 在 
PDOStatement::execute() 之 后 调用 此 函数 (AK) 。 但 是 ， 当 使 用 PgSQL 驱动 时 ， 要 想 
能 绑 定 一 个 LOB 列 作为 流 ， 应 用 程序 必须 在 调用 PDOStatement::execute() 之 前 调用 此 方 
法 ， 否 则 大 对 象 OID 作为 一 个 整数 返回 


参数 


column 结果 集中 的 列 号 (从 1 开始 索引 ) 或 列 名 。 如 果 使 用 列 名 ， 注 意 名 称 应 该 与 由 驱动 返 
回 的 列 名 大 小 写 保 持 一 致 。 


param 将 绑 定 到 列 的 PHP 变量 名 称 
type 通过 PDO::PARAM * 常量 指定 的 参数 的 数据 类 型 。 
maxlen 预 分 配 提示 。 


driverdata 驱动 的 可 选 参数 。 


X lol 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


例 


将 





把 结果 集 输 出 绑 定 到 PHP 变量 


绑 定 结果 集中 的 列 到 PHP 变 量 是 一 种 使 每 行 包含 的 数据 在 应 用 程序 中 立即 可 用 的 有 效 方法 。 
下 面 的 例子 演示 了 PDO 怎样 用 多 种 选项 和 缺 省 值 绑 定 和 检索 列 。 


<?php 
function readData($dbh) { 
$sgl = "SELECT name, colour, calories FROM fruit", 


try { 
$stmt = $dbh->prepare($sql); 
$stmt->execute(); 


/* ”通过 列 号 绑 定 */ 
$stmt->bindColumn(1, $name); 
$stmt->bindColumn(2, $colour); 


/* ”通过 列 名 绑 定 */ 
$stmt->bindColumn('calories', $cals); 


while ($row = $stmt->fetch(PDO::FETCH_BOUND)) £ 
$data = $name . "Nt" . $colour . "Nt" . $cals . "An"; 
print $data; 


J 
catch (PDOException $e) { 
print $e->getMessage(); 


} 
} 
readData($dbh) ; 
?» 

以 上 例 程 会 输出 : 
apple red 150 
banana yellow 175 
kiwi green 75 
orange orange 150 
mango red 200 


strawberry red 25 


PDOStatement::bindParam 


PDOStatement::bindParam — 绑 定 一 个 参数 到 指定 的 变量 名 (PHP 5 >= 5.1.0, PECL pdo >= 
0.1.0) 


bool PDOStatement : :bindParam ( mixed $parameter , mixed &$variable [, int $data type = PD 
HDI DEJ 


绑 定 一 个 PHP 变 量 到 用 作 预 处 理 的 SQL 语句 中 的 对 应 命名 占 位 符 或 问号 占 位 符 。 不 同 于 
PDOStatement::bindValue(), ， 此 变量 作为 引用 被 绑 定 ， 并 只 在 PDOStatement:execute() 被 
调用 的 时 候 才 取 其 值 。 





大 多 数 参 数 是 输入 参数 ， 即 ， 参 数 以 只 读 的 方式 用 来 建立 查询 。 一 些 驱 动 支 持 调 用 存储 过 程 
并 作为 输出 参数 返回 数据 ， 一 些 支持 作为 输入 /输出 参数 ， 既 发 送 数据 又 接收 更 新 后 的 数据 。 


参数 

parameter 参数 标识 符 。 对 于 使 用 命名 占 位 符 的 预 处 理 语 句 ， 应 是 类 似 :name 形式 的 参数 
名 。 对 于 使 用 问号 占 位 符 的 预 处 理 语句 ， 应 是 以 1 开始 索引 的 参数 位 置 。 

variable 绑 定 到 SQL 语句 参数 的 PHP 变量 名 。 


data type 使 用 PDO::PARAM * 常量 明确 地 指定 参数 的 类 型 。 要 从 一 个 存储 过 程 中 返回 一 个 
INOUT 参数 ， 需 要 为 data_type 参数 使 用 按 位 或 操作 符 去 设置 
PDO::PARAM_INPUT_OUTPUT 位 。 


length 预 分 配 提示 。 


driverdata 数据 类 型 的 长 度 。 为 表明 参数 是 一 个 存储 过 程 的 OUT 参数 ， 必 须 明确 地 设置 此 长 
度 。 


driver_options 


3 [B] f 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


M 


实例 


执行 一 条 使 用 命名 占 位 符 的 预 处 理 语 名 


<?php 
/* 通过 绑 定 的 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 


$colour - "red", 

$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories < :calories AND colour = :colour'); 


$sth->bindParam(":calories", $calories, PDO::PARAM INT); 
$sth->bindParam(':colour', $colour, PDO::PARAM STR, 12); 
$sth->execute(); 

?» 


执行 一 条 使 用 问号 占 位 符 的 预 处 理 语 名 


<?php 
/* ”通过 绑 定 的 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 
$colour - "red", 
$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ?"), 
$sth->bindParam(1, $calories, PDO::PARAM INT), 
$sth->bindParam(2, $colour, PDO::PARAM STR, 12); 
$sth->execute(); 
?» 


使 用 INOUT 参数 调用 一 个 存储 过 程 


<?php 
/* 使 用 INOUT 参数 调用 一 个 存储 过 程 */ 
$colour = "red", 


$sth = $dbh->prepare( "CALL puree fruit(?)"), 

$sth->bindParam(1, $colour, PDO: :PARAM STR|PDO::PARAM INPUT OUTPUT, 12); 
$sth->execute(); 

print("After pureeing fruit, the colour is: $colour"), 

?> 


PDOStatement::bindValue 


PDOStatement::bindValue 一 把 一 个 值 绑 定 到 一 个 参数 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 


bool PDOStatement::bindValue ( mixed $parameter , mixed $value [, int $data type = PDO::P 
二 = 一 一 一 一 一 了 一 一 一 一 一 一 
绑 定 一 个 值 到 用 作 预 处 理 的 SQL 语句 中 的 对 应 命名 占 位 符 或 问号 占 位 符 。 


参数 


parameter 参数 标识 符 。 对 于 使 用 命名 占 位 符 的 预 处 理 语 句 ， 应 是 类 似 :name 形式 的 参数 
名 。 对 于 使 用 问号 占 位 符 的 预 处 理 语句 ， 应 是 以 1 开始 索引 的 参数 位 置 。 





value 绑 定 到 参数 的 值 


data type 使 用 PDO::PARAM * 常量 明确 地 指定 参数 的 类 型 。 


退回 值 
成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 
实例 


执行 一 条 使 用 命名 占 位 符 的 预 处 理 语 名 


<?php 
/* 通过 绑 定 的 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 


$colour - "red", 

$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories < :calories AND colour - :colour'); 


$sth->bindValue(":calories", $calories, PDO::PARAM INT); 
$sth->bindValue(':colour', $colour, PDO::PARAM STR); 
$sth->execute(); 

?» 


执行 一 条 使 用 问号 占 位 符 的 预 处 理 语句 


<?php 
/* 通过 绑 定 的 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 
$colour - "red", 
$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ?"), 
$sth->bindValue(1, $calories, PDO::PARAM INT), 
$sth->bindValue(2, $colour, PDO::PARAM STR); 
$sth-»execute(); 
?» 


PDOStatement::closeCursor 


PDOStatement::closeCursor 一 关闭 游标 ， 使 语句 能 再 次 被 执行 。(PHP 5 >= 5.1.0, PECL 
pdo >= 0.9.0) 


说 明 
语法 
bool PDOStatement::closeCursor ( void ) 


PDOStatement::closeCursor() 释放 到 数据 库 服务 的 连接 ， 以 便 发 出 其 他 SOL 语句 ， 但 使 语 
句 处 于 一 个 可 以 被 再 次 执行 的 状态 。 

当 上 一 个 执行 的 PDOStatement 对 象 仍 有 未 取 行 时 ， 此 方法 对 那些 不 支持 再 执行 一 个 
PDOStatement 对 象 的 数据 库 驱 动 非常 有 用 。 如 果 数 据 库 驱动 受 此 限制 ， 则 可 能 出 现 失 序 错 
误 的 问题 。 

PDOStatement::closeCursor() 要 么 是 一 个 可 选 驱动 的 特有 方法 (效率 最 高 ) 来 实现 ， 要 么 是 
在 没有 驱动 特定 的 功能 时 作为 一 般 的 PDO 备用 来 实现 。 一 般 的 各 用 语义 上 与 下 面 的 PHP (X 
码 相同 : 


while ($stmt->fetch()) 


if (!$stmt->nextRowset()) 
break, 
+ while (true); 
?> 


退回 值 
成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


实例 


一 个 PDOStatement::closeCursor() 的 例子 


在 下 面 例子 中 ，$stmt PDOStatement 对 象 返 回 多 行 ， 但 点 用 程序 只 取 第 一 行 ， 让 
PDOStatement 对 象 多 于 一 个 有 未 取 行 的 状态 。 为 确保 应 用 程序 对 所 有 数据 库 驱 动 都 能 正常 
运行 ， 在 执行 $otherStmt PDOStatement 对 象 前 ，$stmt 调用 一 次 
PDOStatement::closeCursor() + 


<?php 
/* 创建 一 个 PDOStatement 对 象 */ 
$stmt = $dbh->prepare( "SELECT foo FROM bar"): 


/* 创建 第 二 个 PDOStatement 对 象 */ 
$otherStmt = $dbh->prepare( "SELECT foobaz FROM foobar"), 


/* 执行 第 一 条 语句 */ 
$stmt->execute(); 


/* ”从 结果 集中 只 取出 第 一 行 */ 
$stmt->fetch(); 


/* The following call to closeCursor() may be required by some drivers */ 
$stmt->closeCursor(); 


/* ”现在 可 以 执行 第 二 条 语句 了 */ 
$otherStmt->execute(); 
?> 


PDOStatement::columnCount 


PDOStatement::columnCount 一 返回 结果 集中 的 列 数 。(PHP 5 >= 5.1.0, PECL pdo >= 
0.2.0) 


说 明 
^3. 
语法 
int PDOStatement::columnCount ( void ) 


使 用 PDOStatement::columnCount() 返回 由 PDOStatement 对 象 代表 的 结果 集中 的 列 数 。 
如 果 是 由 PDO::query() 返回 的 PDOStatement 对 象 ， 则 列 数 计算 立即 可 用 。 


如 果 是 由 PDO::prepare() 返回 的 PDOStatement 对 象 ， 则 在 调用 PDOStatement::execute() 
之 前 都 不 能 准确 地 计算 出 列 数 。 


RIE) (A 


返回 由 PDOStatement 对 象 代表 的 结果 集中 的 列 数 。 如 果 没 有 结果 集 ， 则 
PDOStatement::columnCount() 返回 0。 


实例 
计算 列 数 


下 面 例子 演示 如 何 使 用 PDOStatement::columnCount() 操作 一 个 结果 集 和 一 个 空 


<?php 
$dbh = new PDO('odbc:sample', 'db2insti', 'ibmdb2'); 


$sth - $dbh->prepare( "SELECT name, colour FROM fruit"); 

/* ”计算 一 个 (不 存在 ) 的 结果 集中 的 列 数 */ 

$colcount = $sth->columnCount(); 

print("Before execute(), result set has $colcount columns (should be 0)\n"); 


$sth->execute(); 


/* 计算 结果 集中 的 列 数 */ 
$colcount = $sth->columnCount(), 
print ("After execute(), result set has $colcount columns (should be 2)\n"); 


2» 


以 上 例 程 会 输出 : 


Before execute(), result set has © columns (should be 0) 
After execute(), result set has 2 columns (should be 2) 


PDOStatement::debugDumpParams 


PDOStatement::debugDumpParams 一 打印 一 条 SQL 预 处 理 命令 (PHP 5 >= 5.1.0, PECL 
pdo >= 0.9.0) 


说 明 
语法 
bool PDOStatement : :debugDumpParams ( void ) 


直接 打印 出 一 条 预 处 理 语句 包含 的 信息 。 提 供 正在 使 用 的 SQL 查询 、 所 用 参数 (Params) 
的 数目 、 参 数 的 清单 、 参 数 名 、 用 一 个 整数 表示 的 参数 类 型 (paramtype) 、 键 名 或 位 置 、 
值 、 以 及 在 查询 中 的 位 置 (如 果 当 前 POD 驱动 不 支持 ， 则 为 -1) 。 


此 为 一 个 用 于 调试 的 功能 ， 在 正常 输出 的 情况 下 直接 输出 数据 。 


提示 : 和 直接 将 结果 输出 到 浏览 器 一 样 ， 可 使 用 输出 控制 男 数 来 捕获 当前 玉 数 的 输出 ， 然 后 
(例如 ) 保 存 到 一 个 string 中 。 


只 打印 此 时 此 刻 语句 中 的 参数 。 额 外 的 参数 不 存储 在 语句 中 ， 也 就 不 会 被 输出 。 


返回 值 
没有 返回 值 。 
实例 


PDOStatement::debugDumpParams() 使 用 命名 参数 的 例子 


<?php 
/* 通过 绑 定 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150; 


$colour = "red", 

$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories < :calories AND colour - :colour'); 


$sth->bindParam(":calories", $calories, PDO::PARAM INT); 
$sth->bindValue(':colour', $colour, PDO::PARAM STR, 12); 
$sth->execute(); 


$sth->debugDumpParams(); 


?» 
以 上 例 程 会 输出 : 
SOL: [96] SELECT name, colour, calories 
FROM fruit 
WHERE calories « :calories AND colour - :colour 


Params: 2 

Key: Name: [9] :calories 
paramno--1 

name-[9] ":calories" 
is param-1 

param type-1 

Key: Name: [7] :colour 
paramno--1 

name-[7] ":colour" 

is param-1 

param type-2 


PDOStatement::debugDumpParams() 使 用 未 命名 参数 的 例子 


<?php 


/* 通过 绑 定 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150; 
$colour = "red", 
$name = "apple", 


$sth = $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories < ? AND colour = ?'); 
$sth->bindParam(1, $calories, PDO::PARAM INT), 
$sth->bindValue(2, $colour, PDO: :PARAM STR), 
$sth->execute(); 


$sth->debugDumpParams(); 


?> 


以 上 例 程 会 输出 : 


SOL: [82] SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ? 

Params: 2 

Key: Position £0: 

paramno=0 

name-[0] "" 

is param-1 

param type-1 

Key: Position #1: 

paramno=1 

name-[0] "" 

is param-1 

param type-2 


PDOStatement::errorCode 


PDOStatement::errorCode — 获取 跟 上 一 次 语句 句柄 操作 相关 的 SQLSTATE(PHP 5 >= 
5.1.0, PECL pdo >= 0.1.0) 


说 明 
语法 
string PDOStatement::errorCode ( void ) 


5 PDO::errorCode() 相同 ， 只 是 PDOStatement::errorCode() 只 取 回 PDOStatement 对 象 执 
行 操 作 中 的 错误 码 。 
jx [n] (à 


没有 返回 值 。 


实例 
取 回 一 个 SQLSTATE 码 


<?php 

/* 引发 一 个 错误 -- BONES 数据 表 不 存在 */ 

$err = $dbh->prepare( "SELECT skull FROM bones"), 
S$err-»execute( ); 


echo "XnPDOStatement::errorCode(): "; 
print $err->errorCode(); 
?> 


以 上 例 程 会 输出 : 


PDOStatement::errorCode(): 42502 


PDOStatement::errorlnfo 


PDOStatement::errorlnfo 一 获取 跟 上 一 次 语句 句柄 操作 相关 的 扩展 错误 信息 (PHP 5 >= 
5.1.0, PECL pdo >= 0.1.0) 


说 明 
语法 


array PDOStatement: :errorInfo ( void ) 


PDOStatement::errorlnfo() 返回 一 个 关于 上 一 次 语句 句柄 执行 操作 的 错误 信息 的 数组 。 该 数 
组 包含 下 列 字段 : 

7b 信息 

素 

0 SQLSTATE 错误 码 〈 一 个 由 5 个 字母 或 数字 组 成 的 在 ANSI SQL 标准 中 定义 的 标 

识 符 ) 。 

1 具体 驱动 错误 码 。 

2 具体 驱动 错误 信息 。 
实例 


显示 连接 到 DB2 数 据 库 的 PDO_ODBC 连接 的 errorlnfo() 的 字 
ER 


<?php 

/* 激发 一 个 错误 -- BONES 数据 表 不 存在 */ 

$sth = $dbh->prepare( "SELECT skull FROM bones"), 
$sth->execute(); 


echo "\nPDOStatement: :errorInfo():\n"; 
$arr = $sth->errorInfo(), 
print_r($arr); 

?> 

<pre> 

PDOStatement::errorCode(): 42502 


以 上 例 程 会 输出 : 


PDOStatement::errorInfo(): 
Array 


[0] => 42502 
[1] => -204 
[2] => [IBM][CLI Driver][DB2/LINUX] SQLO204N 


"DANIELS.BONES" 


is an undefined name. 








PDOStatement::execute 


PDOStatement::execute 一 执行 一 条 预 处 理 语句 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 

bool PDOStatement::execute ([ array $input_parameters ] ) 


执行 预 人 处 理 过 的 语句 。 如 果 预 处 理 过 的 语句 含有 参数 标记 ， 必 须 选 择 下 面 其 中 一 种 做 法 : 


e 调用 PDOStatement::bindParam() WE PHP 变量 到 参数 标记 : 如 果 有 的 话 ， 通 过 关联 参 
数 标记 绑 定 的 变量 来 传递 输入 值 和 取得 输出 值 


。 或 传递 一 个 只 作为 输入 参数 值 的 数组 


input_parameters 


一 个 元 素 个 数 和 将 被 执行 的 SQL 语句 中 绑 定 的 参数 一 样 多 的 数组 。 所 有 的 值 作为 
PDO:PARAM STR 对 待 。 


不 能 绑 定 多 个 值 到 一 个 单独 的 参数 ; 比如 ， 不 能 线 定 两 个 值 到 IN O 子 句 中 一 个 单独 的 命名 
参数 。 


绑 定 的 值 不 能 超过 指定 的 个 数 。 如 果 在 input_parameters 中 存在 比 PDO::prepare() 预 处 理 的 
SQL 指定 的 多 的 键 名 ， 则 此 语句 将 会 失败 并 发 出 一 个 错误 。 


3 [E] f 


成 功 时 返回 TRUE, 或 者 在 失败 时 返回 FALSE, 


执行 一 条 绑 定 变量 的 预 处 理 语句 


<?php 
/* ”通过 绑 定 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 


$colour - "red", 

$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « :calories AND colour - :colour'); 


$sth->bindParam(":calories", $calories, PDO::PARAM INT); 
$sth->bindParam(':colour', $colour, PDO::PARAM STR, 12); 
$sth->execute(); 

?» 


使 用 一 个 含有 插入 值 的 数组 执行 一 条 预 处 理 语句 〈 命 名 参数 ) 


<?php 
/* 通过 传递 一 个 含有 插入 值 的 数组 执行 一 条 预 处 理 语句 */ 
$calories = 150, 


$colour - "red", 

$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories < :calories AND colour - :colour'); 


$sth->execute(array(':calories' => $calories, ':colour' => $colour)); 
?> 


使 用 一 个 含有 插入 值 的 数组 执行 一 条 预 处 理 语句 〈 占 位 符 ) 


<?php 
/* ”通过 传递 一 个 插入 值 的 数组 执行 一 条 预 处 理 语句 */ 
$calories = 150, 
$colour - "red", 
$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ?"), 
$sth->execute(array($calories, $colour)); 
?> 


执行 一 条 问号 占 位 符 的 预 处 理 语 名 


<?php 
/* 通过 绑 定 PHP 变量 执行 一 条 预 处 理 语句 */ 
$calories = 150, 
$colour - "red", 
$sth - $dbh->prepare( "SELECT name, colour, calories 
FROM fruit 
WHERE calories « ? AND colour - ?"), 
$sth->bindParam(1, $calories, PDO::PARAM INT), 
$sth->bindParam(2, $colour, PDO::PARAM STR, 12); 
$sth->execute(); 
?» 


使 用 数组 执行 一 条 含有 IN 子 句 的 预 处 理 语 名 


<?php 

/* ”使 用 一 个 数组 的 值 执行 一 条 含有 IN 子 句 的 预 处 理 语句 */ 

$params = array(1, 21, 63, 171), 

/* ”创建 一 个 填充 了 和 params 相 同 数量 占 位 符 的 字符 串 */ 

$place holders = implode(',', array fill(0, count($params), '?')); 


ee 
对 于 $params 数组 中 的 每 个 值 ， 要 预 处 理 的 语句 包含 足够 的 未 命名 占 位 符 。 
语句 被 执行 时 ， $params 数组 中 的 值 被 绑 定 到 预 处 理 语句 中 的 占 位 符 。 
这 和 使 用 PDOStatement::bindParam() 不 一 样 ， 因 为 它 需要 一 个 引用 变量 。 
PDOStatement::execute() 仅 作 为 通过 值 绑 定 的 替代 。 

574 


$sth - $dbh->prepare( "SELECT id, name FROM contacts WHERE id IN ($place holders)"); 
$sth->execute($params); 
?» 


PDOStatement::fetch 


PDOStatement::fetch — 从 结果 集中 获取 下 一 行 (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0) 
说 明 
语法 


mixed PDOStatement::fetch ([ int $fetch style [, int $cursor orientation = PDO::FETCH ORI 
is — 5 


从 一 个 PDOStatement 对 象 相 关 的 结果 集中 获取 下 一 行 。fetch_style 参数 决定 POD 如 何 返 
回 行 。 


参数 


fetch_style 





控制 下 一 行 如 何 返 回 给 调用 者 。 此 值 必须 是 PDO::FETCH_* 系列 常量 中 的 一 个 ， 缺 省 为 
PDO::ATTR_DEFAULT_FETCH_MODE 的 值 (默认 为 PDO::FETCH_BOTH ) 。 


e PDO::FETCH ASSOC : 返回 一 个 索引 为 结果 集 列 名 的 数组 
e PDO::FETCH_BOTH (默认 ) : 返回 一 个 索引 为 结果 集 列 名 和 以 0 开始 的 列 号 的 数组 


e PDO::FETCH BOUND : 返回 TRUE ， 并 分 配 结果 集中 的 列 值 给 
PDOStatement::bindColumn() HERE PHP 变量 。 


e PDO::FETCH CLASS : 一 个 请 求 类 的 新 实例 ， 映 射 结果 集中 的 列 名 到 类 中 对 应 的 属 
性 名 。 如 果 fetch style yat PDO::FETCHCLASSTYPE (例如 : 
_PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE) , ， 则 类 名 由 第 一 列 的 值 决 定 


e PDO::FETCH INTO : 更 新 一 个 被 请 求 类 已 存在 的 实例 ， 映 射 结 果 集中 的 列 到 类 中 命名 
的 属性 

e PDO::FETCH LAZY : 结合 使 用 PDO::FETCH BOTH 和 PDO::FETCH_OBJ， 创 建 供用 
来 访问 的 对 象 变量 名 


e PDO::FETCH NUM : 返回 一 个 索引 为 以 0 开始 的 结果 集 列 号 的 数组 


a 


e PDO::FETCH OBJ : 返回 一 个 属性 名 对 应 结果 集 列 名 的 匿名 对 象 


ki 


cursor orientation 对 于 一 个 PDOStatement 对 象 表示 的 可 滚动 游标 ， 该 值 决定 了 哪 一 行将 
被 返回 给 调用 者 。 此 值 必须 是 PDO:FETCHORI" 系列 常量 中 的 一 个 ， 默 认为 
PDO::FETCH_ORI_NEXT。 要 想 让 PDOStatement 对 象 使 用 可 滚动 游标 ， 必 须 在 用 
PDO::prepare() 预 处 理 SQL 语 句 时 ， 设 置 PDO::ATTR_CURSOR 属性 为 
PDO::CURSOR_SCROLL。 


offset 对 于 一 个 cursor orientation 参数 设置 为 PDO::FETCH_ORI_ABS 的 PDOStatement 
对 象 代表 的 可 滚动 游标 ， 此 值 指定 结果 集中 想 要 获取 行 的 绝对 行 号 。 对 于 一 个 

cursor orientation 参数 设置 为 PDO:FETCH ORI REL 的 PDOStatement 对 象 代 表 的 可 滚动 
游标 ， 此 值 指定 想 要 获取 行 相 对 于 调用 PDOStatement::fetch() 前 游标 的 位 置 


返回 值 


此 函数 (方法) 成 功 时 返回 的 值 依赖 于 提取 类 型 。 在 所 有 情况 下 ， 失 败 都 返回 FALSE 。 


实例 
用 不 同 的 提取 方式 获取 行 


<?php 
$sth = $dbh->prepare( "SELECT name, colour FROM fruit"), 
$sth->execute(); 


/* 运用 PDOStatement::fetch 风格 */ 

print("PDO::FETCH ASSOC: "); 

print("Return next row as an array indexed by column namen"); 
$result = $sth->fetch(PDO: :FETCH ASSOC); 

print_r($result); 

print("\n"); 


print("PDO::FETCH_BOTH: "); 

print("Return next row as an array indexed by both column name and number\n"); 
$result = $sth->fetch(PDO: :FETCH BOTH); 

print_r($result); 

print("Nn"); 


print("PDO::FETCH LAZY: "); 

print("Return next row as an anonymous object with column names as properties\n"); 
$result = $sth->fetch(PDO: :FETCH LAZY); 

print_r($result); 

print("Nn"); 


print("PDO::FETCH OBJ: "); 

print("Return next row as an anonymous object with column names as properties\n"); 
$result - $sth->fetch(PDO: :FETCH OBJ), 

print $result->NAME; 

print("\n"); 

?> 


以 上 实例 会 输出 : 


PDO::FETCH ASSOC: Return next row as an array indexed by column name 
Array 


[NAME] => apple 
[COLOUR] -» red 
) 


PDO::FETCH BOTH: Return next row as an array indexed by both column name and number 
Array 


( 
[NAME] -» banana 


[0] => banana 
[COLOUR] -» yellow 
[1] => yellow 

) 


PDO::FETCH LAZY: Return next row as an anonymous object with column names as properties 
PDOROW Object 


[NAME] -» orange 
[COLOUR] -» orange 
) 


PDO::FETCH OBJ: Return next row as an anonymous object with column names as properties 
kiwi 


Es —————————ÓááÁ— mm U 
使 用 一 个 可 滚动 游标 获取 行 


<?php 
function readDataForwards($dbh) £ 
$sql = "SELECT hand, won, bet FROM mynumbers ORDER BY BET", 
try { 
$stmt = $dbh->prepare($sgl, array(PDO: :ATTR CURSOR => PDO: :CURSOR SCROLL)); 
$stmt - >execute(), 
while ($row = $stmt->fetch(PDO: :FETCH NUM, PDO::FETCH ORI NEXT)) £ 
$data = $row[0] . "Nt" . $row[1] . "ht" . $row[2] . "\n"; 
print $data; 
J 


$stmt - null; 


catch (PDOException $e) ( 
print $e->getMessage(), 
} 
} 
function readDataBackwards($dbh) { 
$sgl = "SELECT hand, won, bet FROM mynumbers ORDER BY bet", 
try { 
$stmt = $dbh->prepare($sgl, array(PDO::ATTR CURSOR => PDO: :CURSOR SCROLL)); 
$stmt - >execute(), 
$row = $stmt--fetch(PDO::FETCH NUM, PDO::FETCH ORI LAST); 
do { 
$data = $row[0] . "Nt" . $row[1] . "ht" . $row[2] . "\n"; 
print $data; 
+ while ($row = $stmt--fetch(PDO::FETCH NUM, PDO::FETCH ORI PRIOR)); 
$stmt - null; 


catch (PDOException $e) { 
print $e->getMessage(); 
} 
} 


print "Reading forwards:\n"; 
readDataForwards($conn), 


print "Reading backwards:\n"; 
readDataBackwards($conn) ; 
?> 


以 上 实例 会 输出 : 


Reading forwards : 
21 10 5 
16 0 5 
19 20 10 


Reading backwards: 
19 20 10 

16 0 5 

21 10 5 


PDOStatement::fetch All 


PDOStatement::fetchAll 一 返回 一 个 包含 结果 集中 所 有 行 的 数组 (PHP 5 >= 5.1.0, PECL pdo 
>= 0.1.0) 

说 明 

语法 


array PDOStatement::fetchAll ([ int $fetch style [, mixed $fetch argument [, array $ctor_ 


a A 





fetch_style 


控制 下 一 行 如 何 返回 给 调用 者 。 此 值 必须 是 PDO::FETCH * 系列 常量 中 的 一 个 ， 缺 省 为 
PDO::ATTR_DEFAULT_FETCH_MODE 的 值 〈 黑 认为 PDO:FETCH BOTH) 。 


想 要 返回 一 个 包含 结果 集中 单独 一 列 所 有 值 的 数组 ， 需 要 指定 PDO::FETCH_COLUMN 。 通 
过 指定 column-index 参数 获取 想 要 的 列 。 


想 要 获取 结果 集中 单独 一 列 的 唯一 值 ， 需 要 将 PDO::FETCH_COLUMN 和 
PDO::FETCH_UNIQUE 按 位 或 。 


想 要 返回 一 个 根据 指定 列 把 值 分 组 后 的 关联 数组 ， 需 要 将 PDO::FETCH_COLUMN 和 
PDO::FETCH_GROUP 按 位 或 。 


fetch argument 根据 fetch style 参数 的 值 ， 此 参数 有 不 同 的 意义 : 

©  PDO::FETCH COLUMN : 返回 指定 以 0 开始 索引 的 列 。 

e PD0::FETCH_CLASS : 返回 指定 类 的 实例 ， 映 射 每 行 的 列 到 类 中 对 应 的 属性 名 。 

© PDo::FETCH FUNC : 将 每 行 的 列 作为 参数 传递 给 指定 的 函数 ， 并 返回 调用 男 数 后 的 结果 。 


ctor args 当 fetch style 参数 为 PDO::FETCH_CLASS ił, BEL AMMUERAHER 


1 [n] f& 


PDOStatement::fetchAll() 返回 一 个 包含 结果 集中 所 有 剩余 行 的 数组 。 此 数组 的 每 一 行 要 么 是 
一 个 列 值 的 数组 ， 要 么 是 属性 对 应 每 个 列 名 的 一 个 对 象 。 


使 用 此 方法 获取 大 结果 集 将 导致 系统 负担 加 重 且 可 能 占用 大 量 网 络 资源 。 与 其 取 回 所 有 数据 
后 用 PHP 来 操作 ， 倒 不 如 考虑 使 用 数据 库 服务 来 处 理 结果 集 。 例 如 ， 在 取 回 数据 并 通过 PHP 
处 理 前 ， 在 SQL 中 使 用 WHERE 和 ORDER BY 子 句 来 限定 结果 。 


实例 


获取 结果 集中 所 有 剩余 的 行 


<?php 
$sth = $dbh->prepare( "SELECT name, colour FROM fruit"), 
$sth->execute(); 


/* 获取 结果 集中 所 有 剩余 的 行 */ 

print("Fetch all of the remaining rows in the result set:\n"); 
$result = $sth->fetchAll(); 

print r($result), 

?> 


以 上 实例 的 输出 为 : 


Fetch all of the remaining rows in the result set: 
Array 


( 
[0] => Array 


[NAME] -» pear 
[0] => pear 
[COLOUR] -» green 
[1] => green 
) 

[1] => Array 
[NAME] -» watermelon 
[0] => watermelon 


[COLOUR] => pink 
[1] => pink 


获取 结果 集中 单独 一 列 的 所 有 值 


下 面 例子 演示 了 如 何 从 一 个 结果 集中 返回 单独 一 列 所 有 的 值 ， 尽 管 SQL 语句 自身 可 能 返回 每 
行 多 列 。 


<?php 
$sth - $dbh->prepare( "SELECT name, colour FROM fruit"); 
$sth->execute(); 


/* 获取 第 一 列 所 有 值 */ 

$result = $sth--fetchAll(PDO::FETCH COLUMN, 0), 
var dump($result), 

?> 


以 上 实例 的 输出 为 : 


Array(3) 


( 
[0] => 
string(5) => apple 
[1] => 
string(4) => pear 
[2] => 
string(10) => watermelon 


根据 单独 的 一 列 把 所 有 值 分 组 


下 面 例 子 演示 了 如 何 返 回 一 个 根据 结果 集中 指定 列 的 值 分 组 的 关联 数组 。 该 数组 包含 三 个 
键 : 返回 的 apple 和 pear 数组 包含 了 两 种 不 同 的 颜色 ， 而 返回 的 watermelon 数组 仅 包含 一 
种 颜色 。 


<?php 

$insert = $dbh->prepare("INSERT INTO fruit(name, colour) VALUES (?, ?)"), 
$insert ->execute(array( "apple", 'green')); 

$insert ->execute(array( "pear", "vellow")), 


$sth - $dbh->prepare( "SELECT name, colour FROM fruit"), 
$sth->execute(); 


/* 根据 第 一 列 分 组 */ 
var dump($sth->fetchA11(PDO: :FETCH COLUMN|PDO: : FETCH GROUP)); 
?> 


以 上 实例 的 输出 为 : 


array(3) 1 
["apple"]-> 
array(2) £ 

[9]=> 

string(5) "green" 
[1]-> 

string(3) "red" 


[ "pear" ] => 
array(2) { 
[0]-> 
string(5) "green" 
[1]-> 
string(6) "yellow" 


["watermelon"]-» 


array(1) { 
[6]=> 
string(5) "green" 


每 行 结果 实例 化 一 个 类 
下 面 列子 演示 了 PDO::FETCH_CLASS 获取 风格 的 行为 。 


<?php 

class fruit { 
public $name; 
public $colour, 


J 


$sth - $dbh->prepare( "SELECT name, colour FROM fruit"); 
$sth->execute(); 


$result = $sth->fetchAl1(PDO::FETCH_CLASS, "fruit"); 


var_dump($result); 
?> 


以 上 实例 的 输出 为 : 


array(3) { 
[0]=> 
object(fruit)#1 (2) { 
[ "name" ]-> 
string(5) "apple" 
[ "colour" ]=> 
string(5) "green" 


[1]=> 

object(fruit)#2 (2) { 
[ "name" ]=> 
string(4) "pear" 
[ "colour" ]=> 
string(6) "yellow" 

i 

[21-> 

object(fruit)#3 (2) £ 
[ "name" ]-> 
string(10) "watermelon" 
[ "colour" ]=> 
string(4) "pink" 


f 1133 FH RR 
下 面 列子 演示 了 PDO::FETCH_FUNC 获取 风格 的 行为 。 


<?php 

function fruit($name, $colour) { 
return "{$name}: {$colour}"; 

} 


$sth = $dbh->prepare("SELECT name, colour FROM fruit"); 
$sth->execute(); 


$result = $sth->fetchAl1(PDO::FETCH_FUNC, "fruit"); 
var_dump($result); 
?> 


以 上 实例 的 输出 为 : 


array(3) { 
[9]=> 
string(12) "apple: green" 
[1]-> 
string(12) "pear: vellow" 
[2]=> 
string(16) "watermelon: pink" 


PDOStatement::fetchColumn 


PDOStatement::fetchColumn 一 从 结果 集中 的 下 一 行 返回 单独 的 一 列 。(PHP 5 >= 5.1.0, 
PECL pdo >= 0.9.0) 


说 明 
语法 
string PDOStatement::fetchColumn ([ int $column number = 0 ] ) 


从 结果 集中 的 下 一 行 返 回 单独 的 一 列 ， 如 果 没 有 了 ， 则 返回 FALSE, 


参数 


column_number 


你 想 从 行 里 取 回 的 列 的 素 引 数字 (以 0 开始 的 索引 ) 。 如 果 没 有 提供 值 ， 则 
PDOStatement::fetchColumn() 获取 第 一 列 。 


3 [E] f 


PDOStatement::fetchColumn() 从 结果 集中 的 下 一 行 返回 单独 的 一 列 。 


注意 : 如 果 使 用 PDOStatement::fetchColumn() 取 回 数据 ， 则 没有 办 法 返回 同一 行 的 另外 一 
列 。 88 


实例 
返回 下 一 行 的 第 一 列 


<?php 
$sth - $dbh->prepare( "SELECT name, colour FROM fruit"); 
$sth->execute(); 


/* 从 结果 集中 的 下 一 行 获取 第 一 列 */ 
print(" 从 结果 集中 的 下 一 行 获取 第 一 列 : Nn"); 
$result = $sth->fetchColumn(); 
print("name = $result\n"); 


print(" 从 结果 集中 的 下 一 行 获取 第 二 列 : Nn"); 
$result = $sth->fetchColumn(1); 


print("colour = $result\n"); 
?> 


以 上 实例 会 输出 : 


从 结果 集中 的 下 一 行 获取 第 一 列 : 
name = lemon 
从 结果 集中 的 下 一 行 获取 第 二 列 : 


colour = red 


PDOStatement::fetchObject 


PDOStatement::fetchObject 一 获取 下 一 行 并 作为 一 个 对 象 返 回 。(PHP 5 >= 5.1.0, PECL 
pdo >= 0.2.4) 
说 明 
语法 
mixed PDOStatement : :fetchObject ([ string $class name = "stdClass" [, array $ctor args 1] 


获取 下 一 行 并 作为 一 个 对 象 返 回 。 此 函数 (方法 ) 是 使 用 PDO::FETCH CLASS 或 
PDO::FETCH_OBJ 风格 的 PDOStatement::fetch() 的 一 种 替代 。 





参数 


class_name 
创建 类 的 名 称 。 
ctor_args 


此 数组 的 元 素 被 传递 给 构造 图 数 。 


3 [E] f 


返回 一 个 属性 名 对 应 于 列 名 的 所 要 求 类 的 实例 ， 或 者 在 失败 时 返回 FALSE, 


PDOStatement::getAttribute 


PDOStatement::getAttribute — 检索 一 个 语句 属性 (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0) 
DL AR 
语法 

mixed PDOStatement::getAttribute ( int $attribute ) 


叶 到 语句 的 一 个 属性 。 当 前 ， 不 存在 通用 的 属性 ， 只 有 驱动 特定 的 属性 : 


e PDO:ATTR CURSOR NAME (Firebird 和 ODBC 特性 ) : 获取 UPDATE ... WHERE 
CURRENT OF 的 游标 名 称 。 


返回 值 


返回 属性 值 。 


PDOStatement::getColumnMeta 


PDOStatement::getColumnMeta 一 返回 结果 集中 一 列 的 元 数据 (PHP 5 >= 5.1.0, PECL pdo 
>= 0.2.0) 


说 明 
BS 
语法 
array PDOStatement::getColumnMeta ( int $column ) 


检索 一 个 在 结果 集中 以 0 开始 索引 的 列 的 元 数据 作为 一 个 关联 数组 。 


注意 : 此 函数 是 实验 性 的 。 此 函数 的 表象 ， 包 括 名 称 及 其 相关 文档 都 可 能 在 未 来 的 PHP 发 布 
版 本 中 未 通知 就 被 修改 。 使 用 本 阔 数 风险 自 担 。 


注意 : 并 非 所 有 PDO 驱动 都 支持 PDOStatement::getColumnMeta(), 


column 结果 集中 以 0 开始 索引 的 列 。 


3 [El] f 


返回 一 个 关联 数组 ， 它 包含 了 下 列表 示 一 个 单独 列 的 元 数据 的 值 : 


北 列 的 元 数据 ** | 名 称 | 值 | | --- | --- | | native type | 用 于 表示 列 值 的 PHP 原生 类 型 。 | | 
driver:decl type | 在 数据 库 中 用 于 表示 列 值 的 SQL 类 型 。 如 果 结 果 集 中 的 列 是 一 个 函数 的 结 
果 ， 则 该 值 不 能 被 PDOStatement::getColumnMeta() 返回 。 | | flags | 任何 设置 于 此 列 的 标 
je. | | name | 通过 数据 库 返 回 的 列 名 。 | | table | 通过 数据 库 返 回 的 该 列 的 表 名 | | len | 该 列 
的 长 度 。 除 浮 点 小 数 外 通常 为 -1 | | precision | 该 列 的 数值 精度 。 除 浮 点 小 数 外 通常 为 0。 || 
pdo type | 以 PDO::PARAM*_ 常量 为 代表 的 列 类 型 。 | 


实例 


检索 列 的 元 数据 


下 面 例子 展示 了 在 一 个 PDO_SQLITE 中 ， 检 索 一 个 通过 函数 (COUNT) 生成 单独 列 的 元 数据 
的 结果 。 


<?php 

$select = $DB->guery( "SELECT COUNT(*) FROM fruit"), 
$meta = $select->getColumnMeta(0), 

var dump($meta); 

?> 


以 上 实例 输出 : 


array(6) { 
[ "native type"]-> 
string(7) "integer" 
["flags"]-» 
array(0) 1 
} 


["name"]=> 

string(8) "COUNT(*)" 
[ "len" ] => 

int(-1) 

[ "Precision" ]=> 
int(0) 
["pdo_type" ]=> 
int(2) 


PDOStatement::nextRowset 


PDOStatement::nextRowset — 在 一 个 多 行 集 语 句 句柄 中 推进 到 下 一 个 行 集 (PHP 5 >= 5.1.0, 
PECL pdo >= 0.2.0) 


说 明 
语法 
bool PDOStatement : :nextRowset ( void ) 


一 些 数据 库 服务 支持 返回 一 个 以 上 行 集 (也 被 称 为 结果 集 ) 的 存储 过 程 。 


PDOStatement::nextRowset() 使 你 能 够 结合 一 个 PDOStatement 对 象 访问 第 二 个 以 及 后 续 的 
行 集 。 上 述 的 每 个 行 集 可 以 有 不 同 的 列 集合 。 


返回 值 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


实例 


获取 由 一 个 存储 过 程 返 回 的 多 个 行 集 


下 面 例子 展示 了 怎样 调用 一 个 存储 过 程 ， 返 回 三 个 行 集 的 MULTIPLE_ROWSETS 。 用 一 个 
do / while 循环 来 循环 调用 PDOStatement::nextRowset() 方法 ， 当 不 再 有 行 集 返 回 时 返回 
false 并 结束 循环 。 


<?php 
$sql = "CALL multiple rowsets()'; 
$stmt = $conn-»query($sq1l); 
Gal Seale 
do { 
$rowset = $stmt--fetchAll(PDO::FETCH NUM); 
if ($rowset) { 
printResultSet($rowset, $i); 
J 


$i++; 
} while ($stmt->nextRowset()); 


function printResultSet(&$rowset, $i) { 
print "Result set $i:\n"; 
foreach ($rowset as $row) { 
foreach ($row as $col) { 
print $col . "Nt"; 


} 
print "\n"; 
} 
print "\n"; 
} 
?» 
以 上 实例 输出 : 


Result set 1: 
apple red 
banana yellow 


Result set 2: 
orange orange 150 
banana yellow 175 


Result set 3: 
lime green 
apple red 
banana yellow 


PDOStatement::rowCount 


PDOStatement::rowCount 一 返回 受 上 一 个 SQL 语句 影响 的 行 数 (PHP 5 >= 5.1.0, PECL pdo 
>= 0.1.0) 


说 明 
语法 
int PDOStatement::rowCount ( void ) 
PDOStatement::rowCount() 返回 上 一 个 由 对 应 的 PDOStatement 对 象 执行 DELETE、 


INSERT、 或 UPDATE 语句 受 影响 的 行 数 。 


如 果 上 一 条 由 相关 PDOStatement 执行 的 SQL 语句 是 一 条 SELECT 语句 ， 有 些 数据 可 能 返 
回 由 此 语句 返回 的 行 数 。 但 这 种 方式 不 能 保证 对 所 有 数据 有 效 ， 且 对 于 可 移植 的 应 用 不 应 依 
赖 于 此 方式 。 


返回 值 


返回 行 数 。 
实例 


返回 删除 的 行 数 
PDOStatement::rowCount() 返回 受 DELETE, INSERT, 或 UPDATE 语句 影响 的 行 数 。 


<?php 

/* M FRUIT 数据 表 中 删除 所 有 行 */ 

$del = $dbh->prepare( "DELETE FROM fruit"), 
$del-»execute(); 


/* ”返回 被 删除 的 行 数 */ 

print("Return number of rows that were deleted:\n"); 
$count = $del->rowCount(); 

print("Deleted $count rows.\n"); 

?> 


以 上 实例 输出 : 


Return number of rows that were deleted: 
Deleted 9 rows. 


计算 由 一 个 SELECT 语句 返回 的 行 数 


对 于 大 多 数 数据 库 ，PDOStatement::rowCount() 不 能 返回 受 一 条 SELECT 语句 影响 的 行 数 。 
替代 的 方法 是 ， 使 用 PDO::query() 来 发 出 一 条 和 原 打 算 中 的 SELECT 语句 有 相同 条 件 表 达 式 
的 SELECT COUNT(*) 语句 ， 然 后 用 PDOStatement::fetchColumn() 来 取得 返回 的 行 数 。 这 
样 应 用 程序 才能 正确 执行 。 


<?php 
$sgl = "SELECT COUNT(*) FROM fruit WHERE calories > 100"; 
if ($res = $conn->query($sql)) { 


/* 检查 符合 SELECT 语句 的 行 数 */ 
if ($res->fetchColumn() > 0) { 


/* 发 出 一 条 真正 的 SELECT 语句 并 操作 返回 的 结果 */ 
$sgl = "SELECT name FROM fruit WHERE calories > 100", 
foreach ($conn->guery($sgl) as $row) £ 


print "Name: "|. $row['NAME'] . "An"; 
} 
} 
/* 没有 匹配 的 行 -- 执行 其 他 */ 
else { 
print "No rows matched the query."; 
J 


J 


$res - null; 
$conn - null; 
?» 


以 上 实例 输出 结果 为 : 


apple 
banana 
orange 
pear 


PDOStatement::setAttribute 


PDOStatement::setAttribute — 设置 一 个 语句 属性 (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0) 
DL AR 
语法 

bool PDOStatement : :setAttribute ( int $attribute , mixed $value ) 


给 语句 设置 一 个 属性 。 当 前 ， 没 有 通用 的 属性 可 以 设置 ， 只 有 了 驱动 特定 的 属性 : 


e PDO:ATTR CURSOR NAME (Firebird 和 ODBC 特性 ) : 为 UPDATE... WHERE 
CURRENT OF 设置 游标 名 称 。 


返回 值 


成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 


PDOStatement::setFetchMode 


PDOStatement::setFetchMode 一 为 语句 设置 默认 的 获取 模式 。(PHP 5 >= 5.1.0, PECL pdo 
>= 0.2.0) 


说 明 
语法 


bool PDOStatement::setFetchMode ( int $mode ) 


bool PDOStatement::setFetchMode ( int $PDO::FETCH COLUMN , int $colno ) 


bool PDOStatement : :setFetchMode ( int $PDO::FETCH CLASS , string $classname , array $ctor 





mode 获取 模式 必须 是 PDO:FETCH * 系列 常量 中 的 一 个 。 
colno 列 号 。 

classname 类 名 。 

ctorargs His HMER, 


object 对 象 。 


jx [n] (à 
成 功 时 返回 TRUE， 或 者 在 失败 时 返回 FALSE, 
实例 


设置 获取 模式 


下 面 的 例子 示范 如 何 用 PDOStatement::setFetchMode() 来 为 一 个 PDOStatement 对 象 更 改 
默认 的 获取 模式 。 


<?php 
$sgl = "SELECT name, colour, calories FROM fruit", 
try { 
$stmt = $dbh->query($sql); 
$result = $stmt->setFetchMode(PDO: :FETCH NUM); 
while ($row = $stmt->fetch()) £ 
print $row[0] . "Nt" . $row[1] . "^t" . $row[2] . "An", 


catch (PDOException $e) { 
print $e->getMessage(); 


J 
?» 

以 上 实例 输出 为 : 
apple red 150 


banana yellow 250 
Orange orange 300 


kiwi brown 75 
lemon yellow 25 
pear green 150 


watermelon pink 90 


PHP SimpleXML P2 


PHP SimpleXML 简介 


SimpleXML eH Ex b iría XML 转换 为 对 象 。 


通过 普通 的 属性 选择 器 或 数组 迭代 器 ， 可 以 处 理 这 个 对 象 ， 就 像 处 理 任何 其 他 对 象 一 样 。 


其 中 的 一 些 画 数 需要 最 新 的 PHP 版 本 。 
安装 


SimpleXML 函数 是 PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 函 数 。 


PHP SimpleXML 2X 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


[SES 
. construct() 
addAttribute() 
addChild() 
asXML() 
attributes() 
children() 
getDocNamespaces() 
getName() 
getNamespaces() 
registerXPathNamespace() 
simplexml import dom() 
simplexml load file() 
simplexml load string() 


xpath() 


创建 一 个 新 的 SimpleXMLElement xt X. 

4 SimpleXML 元 素 添 加 一 个 属性 。 

A SimpleXML 元 素 添加 一 个 子 元 素 。 
从 SimpleXML 元 素 获取 XML 字符 串 。 
获取 SimpleXML 元 素 的 属性 。 
获取 指定 节点 的 子 。 
获取 XML 文档 的 命名 空间 。 
获取 SimpleXML 元 素 的 名 称 。 
从 XML 数据 获取 命名 空间 。 

一 次 XPath 查询 创建 命名 空间 语 境 。 

M DOM 节点 获取 SimpleXMLElement 对 象 。 
M XML 文档 获取 SimpleXMLElement 对 象 。 
M XML 字符 串 获 取 SimpleXMLElement 对 象 。 
对 XML 数据 运行 XPath 查询 。 


PHP 


Ga a al; a; as] 8 al] ay as; aly N | OV | AN | CO 


PHP SimpleXML 常量 


无 。 


PHP  construct() Až 


c. : 
. construct() 函数 创建 一 个 新 的 SimpleXMLElement 对 象 。 


如 果 成 功 ， 则 该 画 数 返回 一 个 对 象 。 如 果 失 败 ， 则 返回 false. 
语法 


. construct(data,options,is url,ns,is prefix) 


参数 描述 
data 必需 。 形 式 良好 的 XML 字符 串 或 XML 文档 的 路 径 或 URL. 
options 可 选 。 规 定 附 加 的 Libxml 参数 。 
is url Alt. Me data 参数 是 否 是 URL, RA x false, 
ns 可 选 。 
is_prefix 可 选 。 


返回 值 


返回 一 个 表示 数据 的 SimpleXMLElement 对 象 。 


例子 


<?php 

$xmlstring = <<<XML 

<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 

XML; 


$xml = new SimpleXMLElement ($xmlstring), 


echo $xml->body[0]; 
?> 


输出 类 似 : 


W3School PHP 参考 手册 


Don"t forget the meeting! 


PHP  construct() 函数 724 


PHP addAttribute() HŽ% 


定义 和 用 法 
addAttribute() Kt SimpleXML 元 素 添加 一 个 属性 。 


KATRE. 
得 法 


class SimpleXMLElement 


string addAttribute(name, value, ns) 


} 
参数 
name 必需 。 规 定 属性 的 名 称 。 
value 必需 。 规 定 属性 的 值 。 
ns 可 选 。 规 定 属性 的 命名 空间 。 
例子 
XML 文件 : 


<?xml version-"1.0" encoding="ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 
«?php 
$xml - simplexml load file("test.xml"); 
$xml->body[0]->addAttribute("type", "small"); 
foreach($xml ->body[0] ->attributes() as $a => $b) 
b $a, 'z"',$b, '"'; 


2 


?> 


W3School PHP 参考 手册 


输出 : 


type-" small" 


PHP addAttribute() RIŽ% 726 


PHP addChild() 函数 


ch 、 : 
addChild() ANAS JE BJ XML 节点 添加 一 个 子 节 点 。 


该 图 数 返 回 一 个 SimpleXMLElement 对 象 ， 这 个 对 象 表示 添加 到 XML 节点 的 子 元 素 。 


语法 


class SimpleXMLElement 


string addchild(name, value, ns) 


} 
参数 描述 
name 必需 。 规 定子 元 素 的 名 称 。 
value 必需 。 规 定子 元 素 的 值 。 
ns 可 选 。 规 定子 元 素 的 命名 空间 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding="IS0-8859-1"?> 
<note> 

<to>George</to> 

«from»John«/from» 
<heading>Reminder</heading> 

<body>Don"t forget the meeting!</body> 
</note> 


PHP 代码 : 
«?php 
$xml - simplexml load file("test.xml"); 
$xml ->body [0] ->addchild("date", "2008-08-08"); 
foreach ($xml->body ->children() as $child) 
ss "Child node: " . $child, 


2 


?> 
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输出 : 


Child node: 2008-08-08 


PHP addChild() 函数 728 


PHP asXML() Ea 


EŠ S 
asXML() 函数 以 字符 串 的 形式 从 SimpleXMLElement 对 象 返回 XML 文档 。 


若 失 败 ， 则 返回 false, 
语法 


class SimpleXMLElement 


string asXML(file) 


参数 描述 
file 可 选 。 如 果 规 定 了 此 参数 ， 则 该 函数 会 把 XML 写 入 一 个 文件 ， 而 不 是 返回 它 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding="IS0-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 
<?php 
if (file exists('test.xml')) 
{ 
$xml = simplexml load file('test.xml'); 
J 
echo $xml->asXML(); 
?> 
输出 : 


George John Reminder Don"t forget the meeting! 


如 果 在 浏览 器 窗口 中 选择 “查看 源 文 件 ”， 会 看 到 这 些 HTML : 


<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 
<body>Don't forget the meeting! </body> 
</note> 


PHP attributes() 2X 


mo . ` 

attributes() 函数 获取 SimpleXML 元 素 的 属性 。 
该 图 数 提供 在 一 个 XML 标签 中 定义 的 属性 和 值 。 
语法 


class SimpleXMLElement 


string attributes( ns , is prefix ) 


J 





BR 描述 
选 。 被 检索 的 属性 的 命名 空间 。 


is prefix Ait, Biz false. 


加 


ns 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 

<note> 

<to>George</to> 

<from>John</from> 

<heading>Reminder</heading> 

«body type="small" important="low">Don't forget the meeting!</body> 
</note> 


PHP 代码 : 
<?php 
$xml = simplexml load file("test.xml"); 
foreach($xml ->body[0] ->attributes() as $a => $b) 
echo $a, rau 1 , $b, VM > 


} 


?> 


输出 : 
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type-"small" important-" low" 


PHP attributes() 函数 732 


PHP children() E325 
定义 和 用 法 

children() 函数 获取 指定 节点 的 子 节点 。 
语法 


class SimpleXMLElement 


{ 
string children(ns,is prefix) 
J 
参数 
ns 可 选 。 
is_prefix Tito MÆ false, 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 
«?php 
$xml - simplexml load file("test.xml"); 
foreach ($xml->children() as $child) 
{ 
echo "Child node: " . $child; 


} 


2» 


输出 类 似 : 


Hi 
BE 


child 
Child 
Child 
Child 


node: 
node: 
node: 
node: 


George 

John 

Reminder 

Don't forget the meeting! 


PHP getDocNamespaces() E25 
定义 和 用 法 


getDocNamespaces() EZ M SimpleXMLElement 对 象 返回 在 XML 文档 中 声明 的 命名 空间 。 


如 果 成 功 ， 该 函数 返回 包含 命名 空间 名 称 ( 带 有 关联 的 URL) 的 数组 。 如 果 失 败 ， 则 返回 


false。 


吾 法 


class SimpleXMLElement 


string getDocNamespaces(recursive) 


参数 描述 
recursive 可 选 。 规 定 是 否 返 回 父子 节 点 中 的 所 有 命名 空间 。 上 默认 是 false。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 

«note xmlns:bz"http://www.w3school.com.cn/example/"» 
<to>George</to> 

<from>John</from> 

<heading>Reminder</heading> 

<b: body>Don't forget the meeting!</b:body> 

</note> 


PHP 代码 : 


«?php 
if (file exists('test.xml')) 


{ 
$xml = simplexml_load_file('test.xml'); 


} 


print r($xml->getDocNamespaces()), 
?> 


输出 类 似 : 
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Array 


[b] => http: //www.w3school.com.cn/example/ 


) 


PHP getDocNamespaces() 函数 736 


PHP getName() HŽ 


mo 、 s 
getName() 函数 从 SimpleXMLElement 对 象 获取 XML 元 素 的 名 称 。 


如 果 成 功 ， 该 画 数 返 回 当前 的 XML 元 素 的 名 称 。 如 果 失 败 ， 则 返回 false. 


语法 


class SimpleXMLElement 


t 
string getName() 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

«from»John«/from» 
<heading>Reminder</heading> 

<b:body>Don"t forget the meeting!</b:body> 
</note> 


PHP 代码 : 


«?php 
if (file exists('test.xml')) 
{ 


$xml = simplexml load file('test.xml'); 
d 

echo $xml->getName(), 

foreach($xml ->children() as $child) 
PE $child->getName(); 


?> 


输出 类 似 : 
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heading 
body 


PHP getName() 函数 738 


PHP getNamespace() 2X 


ch 、 : 
getNamespace() 函数 获取 在 XML 文档 中 使 用 的 命名 空间 。 
如 果 成 功 ， 该 函数 返回 命名 空间 ( 带 有 关联 的 URL) 的 一 个 数组 。 如 果 失 败 ， 则 返回 false, 


语法 


class SimpleXMLElement 
t 


string getNamespace(recursive) 


参数 描述 


recursive 可 选 。 规 定 是 否 返 回 父 子 节点 中 使 用 的 所 有 命名 空间 。 默 认 是 false, 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 

«note xmlns:bz"http://www.w3school.com.cn/example/"» 
<to>George</to> 

<from>John</from> 

<heading>Reminder</heading> 

<b:body>Don't forget the meeting!</b:body> 

</note> 


PHP 代码 : 

«?php 

if (file exists('test.xml')) 
{ 
$xml = simplexml load file('test.xml'); 
J 

print r($xml->getNamespaces()), 

?> 


输出 类 似 : 


Array 


[b] => http: //www.w3school.com.cn/example/ 


PHP registerXPathNamespace() 函数 
定义 和 用 法 
registerXPathNamespace() Ht% P — R XPath 查询 创建 命名 空间 语 境 。 


1) 


class SimpleXMLElement 


{ 

string registerXPathNamespace(prefix, ns) 

J 

参数 描述 

prefix 必需 。 规 定 命 名 空间 前 绥 。 

ns 必需 。 规 定 命名 空间 URL。 必 须 匹 配 XML 文档 中 的 命名 空间 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 

«note xmlns:bz"http://www.w3school.com.cn/example/"» 
<to>George</to> 

<from>John</from> 

<heading>Reminder</heading> 

<b: body>Don't forget the meeting! </b:body> 

</note> 


PHP 代码 : 


«?php 
$xml - simplexml load file("test.xml"); 


$xml ->registerXPathNamespace( "msg", "http://www.w3school.com.cn/example/"); 
$result - $xml-»xpath("msg:body"); 


foreach ($result as $message) 


{ 


echo $message; 


} 


?> 


输出 类 似 : 
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Don"t forget the meeting! 


PHP registerXPathNamespace() 函数 742 


PHP simplexml import dom() 2 
定义 和 用 法 


simplexml import dom() KŽUE DOM 节点 转换 为 SimpleXMLElement 对 象 。 


RAM, Wiz WAGEl false, 
语法 
simplexml import dom(data, class) 
参数 描述 


data 必 规定 要 使 用 的 DOM 节点 。 


= 
THI o 
class 必需 。 规 定 新 对 象 的 class, 


例子 


<?php 

$dom = new domDocument; 
$dom->loadXML ( " <note><from>John</from></note>"), 
$xml - simplexml import dom($dom); 


echo $xml-»from; 
?» 


输出 类 似 : 


John 


PHP simplexml load file() 函数 


定义 和 用 法 
simplexml load file() AGE XML 文档 载 入 对 象 中 。 
如 果 失 败 ， 则 返回 false. 


语法 


simplexml load file(file,class,options,ns,is prefix) 


BR 描述 
file 必需 。 规 定 要 使 用 的 XML 文档 。 
class 可 选 。 规 定 新 对 象 的 class。 
options 可 选 。 规 定 附 加 的 Libxml 参数 。 
ns 可 选 。 
is prefix 可 选 。 


返回 值 


返回 类 SimpleXMLElement 的 一 个 对 象 ， 该 对 象 的 属性 包含 XML 文档 中 的 数据 。 如 果 失 败 ， 
则 返回 false。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 


<?php 

if (file exists('test.xml')) 
{ 
$xml = simplexml load file('test.xml'); 
var dump($xml); 


else 


exit('Error.'); 


J 


2» 


输出 : 


object(SimpleXMLElement )#1 (4) 


["to"]-» string(4) "George" 

[ "from" ]-> string(4) "John" 

["heading"]-» string(8) "Reminder" 

[ "body" ]-> string(29) "Don't forget the meeting!" 
} 


PHP simplexml load string() 函数 


定义 和 用 法 
simplexml load string() KUE XML 字符 串 载 和 对象 中 。 


如 果 失 败 ， 则 返回 false. 
语法 


simplexml load file(string,class,options,ns,is prefix) 


参数 描述 
string 必需 。 规 定 要 使 用 的 XML 字符 串 。 
class 可 选 。 规 定 新 对 象 的 class。 
options 可 选 。 规 定 附 加 的 Libxml 参数 。 
ns 可 选 。 
is prefix 可 选 。 


返回 值 


返回 类 SimpleXMLElement 的 一 个 对 象 ， 该 对 象 的 属性 包含 XML 文档 中 的 数据 。 如 果 失 败 ， 
则 返回 false。 


例子 


<?php 

$xmlstring = <<<XML 

<?xml version="1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting!</body> 
</note> 

XML; 


$xml = simplexml load string($xmlstring); 


var dump($xml); 
?> 


输出 : 


object (SimpleXMLElement )#1 (4) 


["to"]-» string(4) "George" 

[ "from" ]-> string(4) "John" 

[ "Reading" ]-> string(8) "Reminder" 

[ "body" ]-> string(29) "Don't forget the meeting!" 


PHP xpath() HŽ% 


定义 和 用 法 
xpath() 函数 运行 对 XML 文档 的 XPath 查询 。 


如 果 成 功 ， 则 返回 包含 SimpleXMLElement 对 象 的 一 个 数组 。 如 果 失 败 ， 则 返回 false. 


语法 


class SimpleXMLElement 


string xpath(path) 


path 必需 。XPath 路 径 。 


例子 
XML 文件 : 


<?xml version="1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 


«?php 
$xml - simplexml load file("test.xml"); 


$result = $xml->xpath("from"); 


print r($result), 
?> 


输出 : 


Array 
[0] => SimpleXMLElement Object 
[0] => John 


) 
) 


PHP String 函数 


PHP String 简介 


String 字符 串 事 数 人 允许 您 对 字符 串 进行 操作 。 


ro yt 
安装 


String 函数 是 PHP 核心 的 组 成 部 分 。 无 需 安装 即 可 使 用 这 些 画 数 。 


PHP String 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


ERK 
addcslashes() 
addslashes() 
bin2hex() 
chop() 
chr() 
chunk_split() 
convert_cyr_string() 
convert_uudecode() 
convert_uuencode() 
count chars() 
crc32() 
crypt() 
echo() 
explode() 
fprintf() 


get html translation table() 


hebrev() 


描述 
在 指定 的 字符 前 添加 反 斜 杠 。 
在 指定 的 预定 义 字符 前 添加 反 斜 杠 。 


把 ASCII 字符 的 字符 串 转 换 为 十 六 进 制 值 。 


rtrim() 的 别名 。 

从 指定 的 ASCII 值 返回 字符 。 

把 字符 串 分 割 为 一 连 串 更 小 的 部 分 。 

把 字符 由 一 种 Cyrillic 字符 转换 成 另 一 种 。 
对 uuencode 编码 的 字符 串 进 行 解码 。 
使 用 uuencode 算法 对 字符 串 进 行 编码 。 
返回 字符 串 所 用 字符 的 信息 。 

计算 一 个 字符 串 的 32-bit CRC。 

单 向 的 字符 串 加 密 法 (hashing). 

输出 字符 串 。 

把 字符 串 打 散 为 数组 。 

把 格式 化 的 字符 串 写 到 指定 的 输出 流 。 
返回 翻译 表 。 


把 希 伯 来 文本 从 右 至 左 的 流转 换 为 左 至 右 的 流 。 


PHP 


U A U CQ wo wo A A U OC) U CQ CO CQ U om A 
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同上 ， 同 时 把 (\n) 44% <br />。 

把 HTML 实体 转换 为 字符 。 

把 字符 转换 为 HTML 实体 。 

把 一 些 预定 义 的 HTML 实体 转换 为 字符 。 
把 一 些 预 定义 的 字符 转换 为 HTML 实体 。 


hebrevc() 

html entity decode() 
htmlentities() 
htmlspecialchars decode() 


htmlspecialchars() 


implode() 

join() 
levenshtein() 
localeconv() 
Itrim() 

md5() 

md5 file() 
metaphone() 
money format() 
nl langinfo() 


nl2br() 


number format() 


ord() 

parse str() 
print() 
printf() 


quoted printable decode() 


quotemeta() 
rtrim() 


setlocale() 
sha1() 

sha1 file() 
similar text() 
soundex() 
sprintf() 


sscanf() 


JLID C trinr (L7 EH 
PHP String Ex 2x 


把 数组 元 素 组 合 为 一 个 字符 串 。 

implode() 的 别名 。 

返回 两 个 字符 串 之 间 的 Levenshtein 距离 。 
返回 包含 本 地 数字 及 货币 信息 格式 的 数组 。 
从 字符 串 左 侧 删 除 空格 或 其 他 预定 义 字符 。 
计算 字符 串 的 MD5 散 列 。 

计算 文件 的 MD5 散 列 。 

计算 字符 串 的 metaphone 键 。 

把 字符 串 格式 化 为 货币 字符 串 。 
返回 指定 的 本 地 信息 。 

在 字符 串 中 的 每 个 新 行 之 前 插入 HTML 换行 符 。 
通过 于 位 分 组 来 格式 化 数字 。 

返回 字符 串 第 一 个 字符 的 ASCII 值 。 

把 查询 字符 串 解 析 到 变量 中 。 

输出 一 个 或 多 个 字符 串 。 
输出 格式 化 的 字符 串 。 

解码 quoted-printable 字符 串 。 

在 字符 串 中 某 些 预 定义 的 字符 前 添加 反 斜 杠 。 


从 字符 串 的 末端 开始 删除 空白 字符 或 其 他 预定 义 


字符 。 

设置 地 区 信息 (地 域 信息 ) 。 

计算 字符 串 的 SHA-1 散 列 。 

计算 文件 的 SHA-1 散 列 。 

计算 两 个 字符 串 的 匹配 字符 的 数目 。 

计算 字符 串 的 soundex 键 。 

把 格式 化 的 字符 串 写 写 入 一 个 变量 中 。 

根据 指定 的 格式 解析 来 自 一 个 字符 串 的 输入 。 


U OU OU OU CQ wo CQ wo BARA CQ Ww A U U 0 Q U wo MA wm 


CD 


a c CQ wo A A O 


[51 


str ireplace() 

str pad() 

str repeat() 

str replace() 

str rot13() 

str shuffle() 

str split() 

str word count() 


strcasecmp() 
strchr() 


strcmp() 


strcoll() 
strcspn() 


strip tags() 
stripcslashes() 


stripslashes() 


stripos() 


stristr() 
strlen() 


strnatcasecmp() 


strnatcmp() 


strncasecmp() 
strncmp() 


strpbrk() 


strpos() 


strrchr() 


strrev() 


IUD Ctring Had 
| IH oll | g E 女人 


蔡 换 字符 串 中 的 一 些 字 符 。 (对 大 小 写 不 敏感 ) 
把 字符 串 填充 为 新 的 长 度 。 

把 字符 串 重复 指定 的 次 数 。 

蔡 换 字符 串 中 的 一 些 字 符 。 (对 大 小 写 敏 感 ) 
对 字符 串 执行 ROT13 编码 。 

随机 地 打 乱 字符 串 中 的 所 有 字符 。 

把 字符 串 分 割 到 数组 中 。 

计算 字符 串 中 的 单词 数 。 

比较 两 个 字符 串 。 (对 大 小 写 不 敏感 ) 


搜索 字符 串 在 另 一 字符 串 中 的 第 一 次 出 现 。 
strstr() 的 别名 


比较 两 个 字符 串 。 (对 大 小 写 敏感 ) 
比较 两 个 字符 串 〈 根 据 本 地 设置 ) 。 


返回 在 找到 任何 指定 的 字符 之 前 ， 在 字符 串 查 找 
的 字符 数 。 


剥 去 HTML, XML 以 及 PHP 的 标签 。 
删除 由 addcslashes() KHARI EI REAL. 
删除 由 addslashes() 函数 添加 的 反 斜 杠 。 


返回 字符 串 在 另 一 字符 串 中 第 一 次 出 现 的 位 置 
(大 小 写 不 敏感 ) 


查找 字符 串 在 另 一 字符 串 中 第 一 次 出 现 的 位 置 
(大 小 写 不 敏感 ) 


返回 字符 串 的 长 度 。 


使 用 一 种 “自然 "算法 来 比较 两 个 字符 串 (对 大 小 
写 不 敏感 ) 


使 用 一 种 "自然 "算法 来 比较 两 个 字符 串 (对 大 小 
写 敏感 ) 


前 n 个 字符 的 字符 串 比 较 (对 大 小 写 不 敏感 ) 。 
前 n 个 字符 的 字符 串 比 较 (对 大 小 写 敏 感 ) 。 
在 字符 串 中 搜索 指定 字符 中 的 任意 一 个 。 


返回 字符 串 在 另 一 字符 串 中 首次 出 现 的 位 置 (对 
大 小 写 敏 感 ) 


查找 字符 串 在 另 一 个 字符 串 中 最 后 一 次 出 现 的 位 


En 


反 转 字符 串 。 


w Aà o A A OO A A A 


CD 


BP O 


CD 


BP € 


strripos() 


strrpos() 
strspn() 
strstr() 


strtok() 
strtolower() 
strtoupper() 

strtr() 

substr() 

substr compare() 
substr count() 


substr replace() 
trim() 


ucfirst() 
ucwords() 
vfprintf() 
vprintf() 
vsprintf() 


wordwrap() 


PHP String 常量 


查找 字符 串 在 另 一 字符 串 中 最 后 出 现 的 位 置 (对 
大 小 写 不 敏感 ) 


查找 字符 串 在 另 一 字符 串 中 最 后 出 现 的 位 置 (对 
大 小 写 敏 感 ) 


返回 在 字符 串 中 包含 的 特定 字符 的 数目 。 


搜索 字符 串 在 另 一 字符 串 中 的 首次 出 现 《对 大 小 


瑟 敏感 ) 

把 字符 串 分 割 为 更 小 的 字符 串 。 

把 字符 串 转 换 为 小 写 。 

把 字符 串 转 换 为 大 写 。 

转换 字符 串 中 特定 的 字符 。 

返回 字符 串 的 一 部 分 。 

从 指定 的 开始 长 度 比 较 两 个 字符 串 。 

计算 子 串 在 字符 串 中 出 现 的 次 数 。 

把 字符 串 的 一 部 分 蔡 换 为 另 一 个 字符 串 。 

从 字符 串 的 两 端 删 除 空 白字 符 和 其 他 预定 义 字 


No 


把 字符 串 中 的 首 字 符 转 换 为 大 写 。 

把 字符 串 中 每 个 单词 的 首 字 符 转 换 为 大 写 。 
把 格式 化 的 字符 串 写 到 指定 的 输出 流 。 
输出 格式 化 的 字符 串 。 

把 格式 化 字符 串 写 和 变量 中 。 

按照 指定 长 度 对 字符 串 进 行 折 行 处 理 。 


PHP : 指示 支持 该 常量 的 最 早 的 PHP 版 本 。 


Aa Aà OW V V U O Co 


CD 


上 | 上 | 上 |m|mlw 


Ho 


常 


CRYPT_SALT_LENGTH 


CRYPT_STD_DES 


CRYPT_EXT_DES 


CRYPT MD5 


CRYPT BLOWFISH 


HTML SPECIALCHARS 
HTML ENTITIES 
ENT COMPAT 
ENT QUOTES 
ENT NOQUOTES 
CHAR, MAX 

LC CTYPE 

LC NUMERIC 

LC TIME 

LC COLLATE 

LC MONETARY 
LC ALL 

LC MESSAGES 
STR PAD LEFT 
STR PAD RIGHT 
STR PAD BOTH 


描述 PHP 


包含 系统 默认 加 密 方 法 的 长 度 。 对 于 标准 DES 加 
密 ， 长 度 是 2。 

如 果 支 持 2 字符 salt 的 DES 加 密 ， 则 设置 为 1， 否 
则 为 0. 


如 果 支 持 9 字符 salt 的 DES II, NI RIEK 1, © 
则 为 0. 


如 果 支 持 以 $1$ 开 始 的 12 字符 salt 的 MD5 加 密 ， 则 
设置 为 1， 否 则 为 0。 


如 果 支 持 以 $2$ 或 $2a$ 开始 的 16 字符 salt 的 
Blowfish 加 密 ， 则 设置 为 1， 否 则 为 0。 


PHP addcslashes() 函数 
定义 和 用 法 

addcslashes() 函数 在 指定 的 字符 前 添加 反 斜 杠 。 
语法 


addcslashes( string , characters ) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 
characters 可 选 。 规 定 受 addcslashes() 影响 的 字符 或 字符 范围 。 


提示 和 注释 


注释 : 在 对 0，r，n 和 应 用 addcslashes() 时 要 小 心 。 在 PHP 中 ，\0，\r，\n 和 \t 是 预定 义 
的 转 义 序列 。 


实例 


例子 1 
在 本 例 中 ， 我 们 要 向 字符 串 中 的 特定 字符 添加 反 斜 杠 : 


<?php 

$str = "Hello, my name is John Adams."; 
echo $str; 

echo addcslashes(S$str, 'm'); 

echo addcslashes($str,'J'); 

?> 


输出 : 


Hello, my name is John Adams. 
Hello, \my na\me is John Ada\ms. 
Hello, my name is \John Adams. 


例子 2 


在 本 例 中 ， 我 们 要 向 字符 串 中 的 一 个 范围 内 的 字符 添加 反 斜 杠 : 


<?php 

$str = "Hello, my name is John Adams."; 
echo $str; 

echo addcslashes($str,'A..Z'); 

echo addcslashes($str,'a..z'); 

echo addcslashes($str,'a..h') 
?» 


输出 : 


Hello, my name is John Adams. 

\Hello, my name is John NAdams. 

H\e\l\1l\o, \m\y \n\a\m\e \i\s J\o\h\n A\d\a\m\s. 
H\ello, my n\am\e is Jo\hn A\d\ams. 


PHP addslashes() HŽ% 


定义 和 用 法 


addslashes() 函数 在 指定 的 预定 义 字 符 前 添加 反 斜 杠 。 


addslashes(string) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


提示 和 注释 
提示 : 该 画 数 可 用 于 为 存储 在 数据 库 中 的 字符 串 以 及 数据 库 查 询 语句 准 各 合适 的 字符 串 。 


注释 : 默认 情况 下 ，PHP 指令 magic_quotes_gpc 为 on， 对 所 有 的 GET, POST 和 
COOKIE 数据 自动 运行 addslashes()。 不 要 对 已 经 被 magic_quotes_gpc 转 义 过 的 字符 串 使 
用 addslashes()， 因 为 这 样 会 导致 双 层 转 义 。 遇 到 这 种 情况 时 可 以 使 用 画 数 

get magic guotes gpc() 进行 检测 。 


例子 
在 本 例 中 ， 我 们 要 向 字符 串 中 的 预定 义 字符 添加 反 侠 杠 : 


<?php 

$str = "Who's John Adams?"; 

echo $str . " This is not safe in a database guery.<br />", 
echo addslashes($str) . " This is safe in a database query."; 
?> 


输出 : 


Who"s John Adams? This is not safe in a database guery. 
Who“ "s John Adams? This is safe in a database query. 


PHP bin2hex() 函数 


定义 和 用 法 


bin2hex() 函数 把 ASCI 字符 的 字符 串 转 换 为 十 六 进 制 值 。 


语法 
bin2hex(string) 
参数 描述 
string 必需 。 规 定 要 转换 的 字符 串 。 


例子 
在 本 例 中 ， 我 们 将 把 一 个 字符 串 值 从 二 进 制 转 换 为 十 六 进 制 ， 再 转换 回去 : 


<?php 

$str = "Hello world!"; 

echo bin2hex($str); 

echo pack("H*", bin2hex($str)); 
?> 


输出 : 


48656c6c6f20776f726c6421 
Hello world! 


PHP chop() KIr 


定义 和 用 法 
chop() 本 数 从 字符 串 的 末端 开始 删除 空白 字符 或 其 他 预定 义 字 符 。 
该 图 数 的 rtrim() HAY 31 A. 


语法 


chop(string,charlist) 


参数 描述 
string 规定 要 转换 的 字符 串 。 


必需 。 

可 选 。 规 定 从 字符 串 中 删除 哪些 字符 。 如 果 未 设置 该 参数 ， 则 全 部 删除 以 下 字 
charlist — &F : " vo "- ASCII 0, NULL" \t "- ASCII 9, AIRF" \n "- ASCII 10, 新 行 

" wes " - ASCII 11, 垂直 制 表 符 " \r "- ASCII 13, 回 车 ” " - ASCII 32, 空格 


例子 
在 本 例 中 ， 我 们 将 使 用 chop() ERBUASPRERGESTERUDR PIE : 


<?php 

$str = "Hello World!\n\n"; 
echo $str; 

echo chop($str); 

?» 


以 上 代码 输出 的 源 代码 : 


<html> 


<body> 
Hello World! 


Hello World!</body> 


«/html» 


输出 : 


Hello World! Hello World! 


W3School PHP 参考 手册 


PHP chop() Ex 761 


PHP chr() HŽ 


定义 和 用 法 


chr() 函数 从 指定 的 ASCII 值 返回 字符 。 


语法 
chr(ascii) 
参数 
ascii We. ASCII 值 。 


提示 和 注释 


注释 : ascii 参数 可 以 是 十 进 制 、 八 进 制 或 十 六 进 制 。 通 


来 规定 十 六 进 制 。 


例子 


<?php 

echo chr(52); 
echo chr(052), 
echo chr(0x52); 
?> 


输出 : 


HATE 0 来 规定 八进制 ， 通 过 前 置 0x 


PHP chunk split() 函数 


定义 和 用 法 


chunk split() 函数 把 字符 串 分 割 为 一 连 串 更 小 的 部 分 。 


语法 


chunk_split(string, 


参数 
string 必需 。 
length A 3, 
end A] 3, 


提示 和 注释 


length, end) 
规定 要 分 割 的 字符 串 。 


一 个 数字 ， 定 义 字 符 串 块 的 长 度 。 
字符 串 值 ， 定 义 在 每 个 字符 串 块 之 后 放置 的 内 容 。 


注释 : 本 函数 不 改变 原始 字符 忠 。 


例子 
例子 1 


本 例 分 隔 每 个 字符 ， 并 添加 "." : 


<?php 


$str = "Hello world!"; 
echo chunk split($str,1,"."); 


2» 


例子 2 


本 例 将 在 六 个 字符 之 后 分 割 一 次 字符 串 ， 并 添加 "..." : 


<?php 

$str - "Hello world!"; 

echo chunk split($str,6,"..."); 
?> 


输出 : 


Hello ...world!... 


PHP convert cyr string() 函数 


mE. i 
convert cyr string() KGE A — fh Cyrillic 字符 转换 成 另 一 种 。 
被 支持 的 Cyrillic 字符 集 是 : 

e k -koi8-r 

e w-windows-1251 

e | - iso8859-5 

e a-X-cp866 


e d- x-cp866 
e m - x-mac-cyrillic 


convert cyr string(string,from,to) 


string 必需 。 规 定 要 转换 的 字符 串 。 
from 必需 。 源 Cyrillic 字符 集 。 
to 必需 。 目 标 Cyrilic 字符 集 。 


提示 和 注释 


注释 : 本 轿 数 可 安全 用 于 二 进 制 对 象 。 


PHP convert uudecode() E25 
定义 和 用 法 

convert uudecode() 函数 对 uuencode 编码 的 字符 串 进 行 解码 。 
语法 


convert uudecode(string) 


例子 


在 本 例 中 ， 我 们 将 通过 使 用 convert uudecode() 对 uuencode 编码 的 字符 串 进 行 解 码 : 


<?php 
$str = ",2&5L;&\@=V]R;&0A ^"; 
echo convert uudecode($str); 
?> 

a : 


Hello world! 


PHP convert uuencode() E25 
定义 和 用 法 

convert uuencode() 函数 使 用 uuencode 算法 对 字符 串 进行 编码 。 
语法 


convert uuencode(string) 


参数 描述 
string 必需 。 规 定 进行 uuencode 的 字符 串 。 


提示 和 注释 


注释 : 本 了 责 数 把 所 有 字符 串 (包括 二 进 制 的 ) 转换 为 可 打印 的 字符 串 ， 确 保 其 网 络 传输 的 安 
全 。 


注释 : uuencode 的 字符 串 比 原 字符 串 增 大 大 约 35%. 


例子 
在 本 例 中 ， 我 们 将 使 用 convert uuencode() 对 字符 串 进 行 编码 : 


<?php 

$str = "Hello world!"; 

echo convert uuencode($str); 
?> 


输出 : 


„ 285L :8N0-V]R: 80A ^ 


PHP count chars() EX 
定义 和 用 法 

count chars() 函数 返回 字符 串 所 用 字符 的 信息 。 
语法 


count chars( string , mode ) 





参数 描述 
string ”必需 。 规 定 要 检查 的 字符 串 。 


可 选 。 规 定 返回 模式 。 默 认 是 0。 有 以 下 不 同 的 返回 模式 : e -数组 ，ASCII 
值 为 键 名 ， 出 现 的 次 数 为 键 值 1 - WH, ASCI 值 为 键 名 ， 出 现 的 次 数 为 键 

mode ” 值 ， 只 列 出 出 现 次 数 大 于 0 的 值 2 - WHA, ASCI 值 为 键 名 ， 出 现 的 次 数 为 键 
值 ， 只 列 出 出 现 次 数 等 于 0 的 值 3 -字符 串 ， 带 有 所 有 使 用 过 的 不 同 的 字符 
4 -字符 串 ， 带 有 所 有 未 使 用 过 的 不 同 的 字符 


实例 


例子 1 
在 本 例 中 ， 我 们 将 使 用 count chars() 来 检查 字符 串 ， 返 回 模式 设置 为 1: 


<?php 

$str = "Hello World!", 

print r(count chars(S$str,1)); 
?> 


[32] => 
[33] => 
[uži 
[87] -» 
[100] => 1 
[101] => 1 
[108] => 3 
[111] => 2 
[114] => 1 


BEEBE 


例子 2 
在 本 例 中 ， 我 们 将 使 用 count chars() 来 检查 字符 串 ， 返 回 模式 设置 为 3 : 


<?php 

$str = "Hello World!"; 
echo count chars($str,3), 
?> 


输出 : 


! HWdelor 


PHP crc32() E325 


定义 和 用 法 
crc32() 画 数 计算 一 个 字符 串 的 crc32 多 项 式 。 


该 图 数 可 用 于 验证 数据 的 完整 性 。 


语法 
crc32(string) 
参数 描述 
string 必需 。 规 定 要 计算 的 字符 串 。 


说 明 


生成 string 参数 的 32 位 循环 见 余 校 验 码 多 项 式 。 这 通常 用 于 检查 传输 的 数据 是 否 完整 。 


提示 和 注释 


提示 : 由 于 PHP 的 整数 是 带 符号 的 ， 许 多 crc32 校 验 码 将 返回 负 整 数 ， 因 此 您 需要 使 用 
sprintf() & printf() BY "Yu" 格式 符 来 获取 表示 无 符号 crc32 校 验 码 的 字符 串 。 


例子 
例子 1 


在 本 例 中 ， 我 们 将 在 使 用 以 及 不 使 用 "Au" 格式 符 的 情况 下 ， 输 出 crc32() 的 结果 (注意 结果 
是 相同 的 ) 


<?php 

$str = crc32("Hello world!"); 

echo "Without %u: '.$str."<br /»"; 
echo "With %u: ' 

printf ("%u",$str),: 

?» 


输出 : 


Without %u: 461707669 
With %u: 461707669 


例子 2 


在 本 例 中 ， 我 们 将 在 使 用 以 及 不 使 用 "%u" 格式 符 的 情况 下 ， 
是 不 相同 的 ) 


<?php 

$str = crc32("Hello world."), 

echo "Without %u: '.$str."<br /»"; 
echo "With %u: '; 
printf ("%u",$str): 
?» 


输出 : 


Without %u: -1959132156 
With %u: 2335835140 


AHE crc32() 的 


PHP crypt() HŽ 


定义 和 用 法 
crypt() 函数 返回 使 用 DES、Blowfish 或 MD5 加 密 的 字符 串 。 


在 不 同 的 操作 系统 上 ， 本 函数 的 行为 不 同 ， 某 些 操作 系统 支持 一 种 以 上 的 算法 类 型 。 在 安装 
at, PHP 会 检查 什么 算法 可 用 以 及 使 用 什么 算法 。 


crypt(str, salt) 


参 ; 
$ 述 
数 描述 


str 必需 。 规 定 要 编码 的 字符 串 。 
可 选 。 用 于 增加 被 编码 字符 数目 的 字符 串 ， 以 使 编码 更 加 安全 。 如 果 未 提供 salt 


sel — 参数 ， 则 每 次 调用 该 画 数 时 会 随机 生成 一 个 。 

说 明 

确切 的 算法 依赖 于 salt 参数 的 格式 和 长度 。 

下 面 是 与 crypt() 函数 一 起 使 用 的 一 些 常量 。 在 安装 时 ， 由 PHP 设置 这 些 常量 : 


e [CRYPT SALT LENGTH] 
e [CRYPT STD DES] 

e [CRYPT EXT. DES] 

e [CRYPT MD5] 

e [CRYPT BLOWFISH] 


提示 和 注释 
提示 : 解密 函数 是 没有 的 。crypt() 函数 使 用 一 种 单 向 算法 。 


例子 


在 本 例 中 ， 我 们 将 测试 不 同 的 算法 : 


<?php 
if (CRYPT STD DES -- 1) 


echo "Standard DES: ".crypt("hello world")."\n<br />"; 
} 


else 


echo "Standard DES not supported.\n<br /»"; 
J 


if (CRYPT EXT DES -- 1) 


echo "Extended DES: ".crypt("hello world")."\n<br />", 
H 


else 


echo "Extended DES not supported.\n<br />"; 
H 


if (CRYPT MD5 -- 1) 


{ 
echo "MD5: ".crypt("hello world")."\n<br />", 
J 


else 


echo "MD5 not supported.\n<br />", 
J 


if (CRYPT BLOWFISH -- 1) 


{ 
echo "Blowfish: ".crypt("hello world"); 
J 


else 


echo "Blowfish DES not supported.", 
J 


?> 


偷 出 类 似 (依赖 于 操作 系统 ) 


Standard DES: $1$r35.Y52.$iyiFuvM.zFGsscpUOaZ4e. 
Extended DES not supported. 

MD5: $1$BN1.012.$80BI/AmufxK6Tq89M12mk/ 
Blowfish DES not supported. 


PHP echo() 函数 


定义 和 用 法 


echo() 画 数 输出 一 个 或 多 个 字符 串 。 


语法 
echo(strings) 
参数 描述 
strings 必需 。 一 个 或 多 个 要 发 送 到 输出 的 字符 串 。 


提示 和 注释 


注释 : echo() 实际 上 不 是 一 个 函数 ， 因 此 您 无 需 对 其 使 用 括号 。 不 过 ， 如 果 


传递 一 个 或 多 个 参数 ， 那 么 使 用 括号 会 发 生 解析 错误 。 
提示 : echo() 函数 比 print() 函数 快 一 点 点 。 


提示 : echo() 函数 可 以 使 用 简化 语法 。 参 见 例子 5. 


例子 
例子 1 


<?php 

$str = "Who"s John Adams?", 

echo $str; 

echo "<br />"; 

echo $str."«br />I don't know!"; 
?» 


输出 : 


Who's John Adam? 
Who's John Adam? 
I don't know! 


例子 2 


<?php 

echo "This text 
spans multiple 
lines."; 

?» 


输出 : 


This text spans multiple lines. 


例子 3 


<?php 
echo "This ", "string ", "was ','made ", "with multiple parameters'; 
?» 


输出 : 


This string was made with multiple parameters 


例子 4 
单 引号 和 双 引 号 的 不 同 之 处 。 单 引号 仅 输 出 变量 名 ， 而 不 是 值 : 


<?php 

$color - "red"; 

echo "Roses are $color"; 
echo "<br />"; 

echo "Roses are $color'; 
?» 


输出 : 


Roses are red 
Roses are $color 


例子 5 


简化 语法 : 


<html> 
<body> 


<?php 
$color - "red"; 
?» 


<p>Roses are <?=$color?></p> 


</body> 
</html> 


PHP explode() 函数 
定义 和 用 法 

explode() 函数 把 字符 串 分 割 为 数组 。 
语法 


explode(separator, string,1imit) 


参数 描述 
separator 必需 。 规 定 在 哪里 分 割 字 符 串 。 
string 必需 。 要 分 割 的 字符 串 。 
limit 可 选 。 规 定 所 返回 的 数组 元 素 的 最 大 数目 。 
说 明 


本 画 数 返 回 由 字符 串 组 成 的 数组 ， 其 中 的 每 个 元 素 都 是 由 separator 作为 边界 点 分 割 出 来 的 子 
FRA. 


separator 参数 不 能 是 空 字符 串 。 如 果 separator AAFP (“) , explode() 将 返回 
FALSE。 如 果 separator 所 包含 的 值 在 string 中 找 不 到 ， 那 么 explode() 将 返回 包含 string 中 
单个 元 素 的 数组 。 


如 果 设 置 了 limit 参数 ， 则 返回 的 数组 包含 最 多 jj 让 个 元 素 ， 而 最 后 那个 元 素 将 包含 string 的 
剩余 部 分 。 


如 果 limit 参数 是 负数 ， 则 返回 除了 最 后 的 -imt 个 元 素 外 的 所 有 元 素 。 此 特性 是 PHP 5.1.0 
中 新 增 的 。 

提示 和 注释 

注释 : 参数 limit 是 在 PHP 4.0.1 中 加 入 的 。 


注释 : 由 于 历史 原因 ， 虽 然 implode() 可 以 接收 两 种 参数 顺序 ， 但 是 explode() 不 行 。 你 必须 
保证 separator 参数 在 string 参数 之 前 才 行 。 


例子 
在 本 例 中 ， 我 们 将 把 字符 串 分 割 为 数组 : 


<?php 

$str = "Hello world. It's a beautiful day."; 
print r (explode(" ",$str)), 

?> 


输出 
Array 
( 
[0] => Hello 
[1] => world. 
[2] => It's 
[3] => a 


[4] => beautiful 
[5] => day. 


PHP fprintf() 函数 


定义 和 用 法 
fprintf) 范 数 把 格式 化 的 字符 串 写 到 指定 的 输出 流 ( 例 如 : 文件 或 数据 库 ) 。 
ER 2 [n] t 5 5e TERI KE. 


fprintf(stream, format, argi, arg2,argt++) 


参数 描述 
stream 可 选 。 规 定 在 哪里 写 / 输 出 字符 串 。 
format 必需 。 转 换 格式 。 
arg1 必需 。 规 定 插 到 format 字符 串 中 第 一 个 % 符号 处 的 参数 。 
arg2 可 选 。 规 定 插 到 format 字符 串 中 第 二 个 % 符号 处 的 参数 。 
arg++ 可 选 。 规 定 插 到 format 字符 串 中 第 三 、 四 等 等 % 符号 处 的 参数 。 
说 明 


参数 format 是 转换 的 格式 ， 以 百分比 符号 ("%") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
fü: 


e 9696 - 返回 百分比 符号 

e %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

。 %d - 带 符号 十 进 制 数 

e %e - 可 续 计 数 法 (比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e %f - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e %o - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 

e %X - 十 六 进 制 数 (ASFA) 


arg1, arg2, ++ 等 参数 将 插入 到 主 字 符 串 中 的 百 分 号 (%) FSR. ARAE RS IB]. TET 
一 个 96 符号 中 ， 插 入 arg1， 在 第 二 个 % RES A, A arg2， 依 此 类 推 。 
提示 和 注释 


注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 被 插入 % 符号 之 后 ， 由 数字 
和 "$" 组 成 。 请 参见 例子 3。 


提示 : AXK: printf), sprintf), vfprintf()、 vprintf() 以 及 vsprintf()。 


例子 
例子 1 


<?php 

$str = "Hello": 

$number - 123; 

$file = fopen("test.txt","w"); 

echo fprintf($file,"%s world. Day number %u",$str, $number); 
?> 


输出 : 


27 


以 下 文本 将 写 入 "test.txt" : 


Hello world. Day number 123 


例子 2 


<?php 

$number = 123, 

$file = fopen("test.txt","w"); 
fprintf($file, "%F", $number); 
?> 


输出 : 


123.000000 


PIF 3 


使 用 占 位 符 : 


<?php 

$number = 123, 

$file = fopen("test.txt","w"); 

fprintf($file, "With 2 decimals: %1\$.2f\nWith no decimals: %1\$u", $number); 
?> 


以 下 文本 将 写 入 "test.txt" : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP get html translation table() 函数 


定义 和 用 法 


get html translation table() 函数 返回 被 htmlentities() 和 htmlspecialchars() 函数 使 用 的 翻译 
Ko 


语法 
get html translation table(function, guotestyle) 


参数 描述 


可 选 。 规 定 返 回 哪 个 翻译 表 。 默 认 是 HTML_SPECIALCHARS。 可 能 的 值 : 
HTML ENTITIES - 翻译 所 有 需要 URL 编码 的 字符 ， 以 便 正确 地 显示 在 网 页 


function I. HTML sPECIALCHARS - 翻译 某 些 需要 URL 编码 的 字符 ， 以 便 正 确 地 显示 
在 网 页 上 。 
可 选 。 定 义 如 何 对 单 引 号 和 双 引 号 进行 编码 。 默 认 是 ENT_COMPAT. FREE 
salt Já : ENT COMPAT - 编码 双 引 号 ， 不 编码 单 引 号 。 ENT QUOTES - 编码 双 引 号 


和 单 引 号 。 ENT_NoQuoTES - 不 编码 单 引号 或 双 引 号。 
说 明 


提示 和 注释 


提示 : 一 些 字符 可 以 按照 若干 种 方式 进行 编码 。get_html_translation_table() 返回 
码 。 


xil 
DR 
zu 
e 
2 


例子 
在 本 例 中 ， 我 们 将 展示 两 种 翻译 表 : 


<?php 

print r (get html translation table()), 

echo "<br />"; 

print r (get html translation table(HTML ENTITIES)), 
?> 


输出 : 


W3School PHP 参考 手册 


Array 


( 
lind 
) 


=> " 


Array 


( 
[ ] 
[x] 
1 
[=] 
[7] 
U] 
L] 
[34] 
[À] 
[a] 
[È] 
[i] 
[5] 
[6] 
[2] 
[Ü] 
[à] 
[à] 
[è] 
[i] 
[8] 
[ô] 
[2] 
[à] 
t"] 
) 


PHP get html translation table() 函数 


=> 
=> H 
=> ~ 
=> — 
=> 
=> “ 
=> A 
=> 
=> A 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
=> 
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PHP hebrev() 2X 


mo . : 

定义 和 用 法 

hebrev() 函数 把 希 伯 来 文本 从 右 至 左 的 流转 换 为 左 至 右 的 流 。 
只 有 224 至 251 之 间 的 ASCI 字符 ， 以 及 标点 符号 受到 影响 


hebrev(string,maxcharline) 


参数 描述 

string 必需 。 希 伯 来 文本 。 

salt 规定 每 行 的 最 大 字符 数 。 如 果 可 能 ，hebrev() 将 避免 把 单词 断 开 。 
提示 和 注释 


提示 : hebrev() 和 hebrevc() 可 以 把 希 伯 来 逻辑 文本 转换 为 希 伯 来 可 见 文本 。 希 伯 来 可 见 文本 
不 需要 特殊 的 右 至 左 字 符 支持 ， 这 使 它 对 于 在 web 上 显示 希 伯 来 文本 很 有 用 你 。 


PHP hebrevc() 函数 


定义 和 用 法 


hebrevc() 函数 把 希 伯 来 文本 从 右 至 左 的 流转 换 为 左 至 右 的 流 。 它 也 会 把 新 行 (\n) 转换 为 <br 


/> 


o 


只 有 224 Z 251 Z iJ ASCI 字符 ， 以 及 标点 符号 受到 影响 。 


语法 


hebrev(string, maxcharline) 


参数 描述 

string 必需 。 希 伯 来 文本 。 

salt 规定 每 行 的 最 大 字符 数 。 如 果 可 能 ，hebrev() 将 避免 把 单词 断 开 。 
提示 和 注释 


提示 : hebrev() 和 hebrevc() 可 以 把 希 伯 来 逻辑 文本 转换 为 希 伯 来 可 见 文本 。 希 伯 来 可 见 文本 
不 需要 特殊 的 右 至 左 字 符 支 持 ， 这 使 它 对 于 在 web 上 显示 希 伯 来 文本 很 有 用 人 处。 


PHP html entity decode() 函数 


res. : 
html entity decode() 函数 把 HTML 实体 转换 为 字符 。 


html entity decode() 是 htmlentities() I R EŻ 


语法 


html entity decode(string, quotestyle, character -set) 


参数 描述 
string 必需 。 规 定 要 解码 的 字符 串 。 
可 选 。 规 定 如 何 解码 单 引 号 和 双 引 号 。 ENT_coMPAT - 默认 。 仅 解码 双 引 
quotestyle ”号 。 ENT_QuoTES - 解码 双 引 号 和 单 引 号 。 ENT_NoQuoTES -不 解码 任何 引 
B. 
可 选 。 字 符 串 值 ， 规 定 要 使 用 的 字符 集 。 Iso- 8859-1 - 默认 。 西 欧 。 
1S0-8859-15 a. (增加 Euro 符号 以 及 法 语 、 芬 兰 语 字母 ) 。 UTF-8 - 
character- ASCII 兼容 多 字 节 8 比特 Unicode cpase - DOS m Cyrillic 字符 集 
set cp1251 - Windows 专用 Cyrillic 字符 集 cp1252 - Windows 专用 西欧 字符 


& KOI8-R -俄语 cB2312 - 简体 中 文 ， 国 家 标准 字符 集 Bres - 繁体 中 文 


BIG5-HKSCS - Big5 香港 扩展 shift_JIS - HZ Euc-JP - Hi& 


提示 和 注释 


提示 : 无 法 被 识别 的 字符 集 将 被 忽略 ， 并 由 ISO-8859-1 RE. 


例子 


<?php 

$str = "John &amp; &#039;Adams&#039;"; 

echo html entity decode($str); 

echo "«br /»"; 

echo html entity decode($str, ENT QUOTES); 
echo "«br /»"; 

echo html entity decode($str, ENT NOQUOTES); 
?> 


浏览 器 输出 : 


John 4 "Adams! 
John & "Adams! 
John & "Adams! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 这 些 HTML : 


<html> 

<body> 

John 4 &#039;Adams&#039;<br /> 
John 8 "Adams"<br /> 

John & &#039; Adams&#039; 
</body> 

«/html» 


PHP htmlentities() E325 
定义 和 用 法 

htmlentities() 函数 把 字符 转换 为 HTML 实体 。 
语法 


htmlentities(string, quotestyle, character -set) 


参数 描述 
string 规定 要 转换 的 字符 串 。 


必需 。 
可 选 。 规 定 如 何 编码 单 引 号 和 双 引 号 。 ENT_coMPAT - 默认 。 仅 编码 双 引 


quotestyle o ENT QUOTES - 编码 双 引 号 和 单 引号 。 ENT_NoQuoTES - 不 编码 任何 引 


可 选 。 字 符 串 值 ， 规 定 要 使 用 的 字符 集 。 Iso-8859-1 - 默认 。 西 欧 。 
Is0-8859-15 - 西欧 (增加 Euro 符号 以 及 法 语 、 芬 兰 语 字 母 ) 。 UTF-8 - 
character- ASCII 兼容 多 字 节 8 比特 Unicode cpsee - DOS 专用 Cyrillic 字符 集 
set cp1251 - Windows 专用 Cyrillic 字符 集 cp1252 - Windows 专用 西欧 字符 
& KOI8-R -俄语 GB2312 - 简体 中 文 ， 国 家 标准 字符 集 BI65 - 繁体 中 文 


BIG5-HKSCS - Big5 香港 扩展 shift_JISs -日 语 Euc -JP -日 语 


提示 和 注释 


提示 : 无 法 被 识别 的 字符 集 将 被 忽略 ， 并 由 ISO-8859-1 RE. 


例子 


<html> 

<body> 

<?php 

$str = "John 8 'Adams'"; 

echo htmlentities($str, ENT COMPAT), 
echo "<br /»"; 

echo htmlentities($str, ENT OUOTES), 
echo "<br /»"; 

echo htmlentities($str, ENT NOOUOTES), 
?> 

</body> 

</html> 


浏览 器 输出 : 


John 4 "Adams! 
John & "Adams! 
John & "Adams! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 这 些 HTML : 


<html> 

<body> 

John &amp; 'Adams'«br /> 

John «amp, &#039;Adams&#039;<br /> 
John &amp; "Adams! 

</body> 

</html> 


PHP htmlspecialchars decode() 函数 


rm. N 
htmlspecialchars decode() KE — EE 3L BJ HTML 实体 转换 为 字符 。 
会 被 解码 的 HTML 实体 是 : 


e & 成 为 & (和 号 ) 
e "成 为 "( 双 引 号 ) 
。' 成 为 ' ( 单 引号 ) 
。 < 成 为 < (小 于 ) 
。 > 成 为 > (大 于 ) 


语法 


htmlspecialchars decode(string, guotestyle) 


参数 描述 
string 必需 。 规 定 要 解码 的 字符 串 。 
选 。 规 定 如 何 解码 单 引 号 和 双 引 号 。 ENT_coMPAT - 默认 。 仅 解码 双 引 


guotestyle ENT QuOTES - 解码 双 引 号 和 单 引 号 。 ENT_NoQuoTES - 不 解码 任何 引 


ap do al 


例子 


<?php 

$str = "John &amp; &#039;Adams&#039;"; 

echo htmlspecialchars decode($str); 

echo "«br /»"; 

echo htmlspecialchars decode($str, ENT QUOTES); 
echo "<br />"; 

echo htmlspecialchars decode($str, ENT NOQUOTES); 


?> 
浏览 器 输出 : 


John & "Adams! 
John & "Adams! 
John & "Adams! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 这 些 HTML : 


<html> 

<body> 

John & &#039;Adams&#039;<br /» 
John & 'Adams'«br /> 

John & &#039; Adams&#039; 
</body> 

</html> 


PHP htmlspecialchars() 函数 


定义 和 用 法 


htmlspecialchars() 郴 数 把 一 些 预 定义 的 字符 转换 为 HTML 实体 。 


预定 义 的 字符 是 : 


e 8 (和 号 ) 成 为 & 
。"”( 双 3 引号) 成为" 
e' (45/15) RA" 
e < (小 于 ) 成 为 < 
e > (KF) 成 为 > 


语法 


htmlspecialchars(string, quotestyle, character-set) 


参数 


string 


guotestyle 


character- 
set 


描述 
规定 要 转换 的 字符 串 。 


必需 。 
可 选 。 规 定 如 何 编码 单 引 号 和 双 引 号 。 ENT_coMPAT - 默认 。 仅 编码 双 引 
o ENT QUOTES - 编码 双 引 号 和 单 引 号 。 ENT_NoQuoTES - 不 编码 任何 引 


o 


可 选 。 字 符 串 值 ， 规 定 要 使 用 的 字符 集 。  150-8859-1 - 默认 。 西 欧 。 
Is0-8859-15 - 西欧 (增加 Euro 符号 以 及 法 语 、 芬 兰 语 字 母 ) 。 UTF-8 - 
ASCII 兼容 多 字 节 8 比特 Unicode cpsee - DOS 专用 Cyrillic 字符 集 
cp1251 - Windows 专用 Cyrillic 字符 集 cp1252 - Windows 专用 西欧 字符 
集 KOI8-R -俄语 cB2312 - 简体 中 文 ， 国 家 标准 字符 集 BI65 - 繁体 中 文 


BIG5-HKscs - Big5 香港 扩展 shift_JIS -日 语 Euc-JP -日 语 


din ul al & 


提示 和 注释 


提示 : 无 法 被 识 另 


例子 


1 的 字符 集 将 被 忽略 ， 并 由 ISO-8859-1 RE. 


<html> 

<body> 

<?php 

$str = "John 8 'Adams'"; 

echo htmlspecialchars($str, ENT COMPAT), 
echo "<br /»"; 

echo htmlspecialchars($str, ENT QUOTES); 
echo "<br />"; 

echo htmlspecialchars($str, ENT NOOUOTES), 


</body> 
</html> 


浏览 器 输出 : 


John & "Adams! 
John & "Adams! 
John & "Adams! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 这 些 HTML : 


<html> 

<body> 

John &amp; 'Adams'«br /> 

John «amp, &#039;Adams&#039;<br /> 
John &amp; "Adams! 

</body> 

</html> 


PHP implode() 函数 
定义 和 用 法 
implode() 函数 把 数组 元 素 组 合 为 一 个 字符 串 。 
语法 

implode(separator,array) 


参数 描述 
separator 可 选 。 规 定数 组 元 素 之 间 放 置 的 内 容 。 上 默认 是 " (FB). 
需 。 要 结合 为 字符 串 的 数组 。 


array 必需 
说 明 
虽然 separator 参数 是 可 选 的 。 但 是 为 了 向 后 兼容 ， 推 荐 您 使 用 使 用 两 个 参数 。 
提示 和 注释 


注释 : implode() 可 以 接收 两 种 参数 顺序 。 但 是 由 于 历史 原因 ，explode() 是 不 行 的 。 你 必须 保 
证 separator 参数 在 string 参数 之 前 才 行 。 


例子 


<?php 
$arr = array( "Hello", "World!", "Beautiful", "Day!"), 
echo implode(" ",$arr), 
?> 
输出 : 


Hello World! Beautiful Day! 


PHP join() HŽ% 


定义 和 用 法 
join() 范 数 把 数组 元 素 组 合 为 一 个 字符 串 。 
join) 函数 是 implode() HAHN 31 A. 


语法 


join(separator,array) 


参数 描述 
separator 可 选 。 规 定数 组 元 素 之 间 放 置 的 内 容 。 默 认 是 (FB). 
需 。 要 结合 为 字符 串 的 数组 。 


array vá 
说 明 
虽然 separator 参数 是 可 选 的 。 但 是 为 了 向 后 兼容 ， 推 荐 您 使 用 使 用 两 个 参数 。 
提示 和 注释 


注释 : join) 可 以 接收 两 种 参数 顺序 。 但 是 由 于 历史 原因 ，explode() 是 不 行 的 。 你 必须 保证 
separator 参数 在 string 参数 之 前 才 行 。 


例子 


<?php 
$arr = array('Hello','World!','Beautiful',' 'Day!'); 
echo join(" ",$arr); 
?> 
输出 : 


Hello World! Beautiful Day! 


PHP levenshtein() HŽ% 


ch. S 
levenshtein() E2038] A 4 5e 4 XZ ja] BY Levenshtein 距离 。 


Levenshtein 距离 ， 又 称 编辑 距离 ， 指 的 是 两 个 字符 串 之 间 ， 由 一 个 转换 成 另 一 个 所 需 的 最 少 
编辑 操作 次 数 。 许 可 的 编辑 操作 包括 将 一 个 字符 替换 成 另 一 个 字符 ， 插 入 一 个 字符 ， 删 除 一 
个 字符 。 


例如 把 kitten 转换 为 sitting : 


1. sitten (ks) 
2. sittin (ei) 
3. sitting (—9g) 


levenshtein() 函数 给 每 个 操作 (替换 、 插 入 和 删除 ) 相同 的 权重 。 不 过 ， 您 可 以 通过 设置 可 
选 的 insert, replace, delete 参数 ， 来 定义 每 个 操作 的 代价 。 


语法 


levenshtein(string1, string2, insert, replace, delete) 


BR 描述 
string1 必需 。 要 对 上 比 的 第 一 个 字符 串 。 
string2 必需 。 要 对 上 比 的 第 二 个 字符 串 。 
insert 可 选 。 插 和 一 个 字符 的 代价 。 默 认 是 1。 
replace 可 选 。 蔡 换 一 个 字符 的 代价 。 默 认 是 1。 
delete 可 选 。 删 除 一 个 字符 的 代价 。 默 认 是 1. 


B XY: 
提示 和 LE 
注释 : 如 果 其 中 一 个 字符 串 超过 255 SSH, levenshtein() HURE -1。 
注释 : levenshtein() Hut ANETTER. 


注释 : levenshtein() KZE similar text() 函数 更 快 。 不 过 ，similar_text() 函数 提供 需要 更 少 
修改 的 更 精确 的 结果 。 


例子 


<?php 
echo levenshtein( "Hello World", "ello World"), 
echo "<br /»"; 


echo levenshtein( "Hello World", "ello World", 10,20,30), 
?» 


输出 : 


30 


PHP localeconv() 2% 


定义 和 用 法 


localeconv() 函数 返回 包含 本 地 数字 及 货币 信息 格式 的 数组 。 
localeconv() WUR [Bl E F2 ZR 763 : 


e [decimal point] - 小 数 点 字符 
e [thousands sep] - 千 位 分 隔 符 
e [int curr symbol] - 货币 符号 (例如 : USD) 
e [currency symbol] - 货币 符号 (例如 : $) 
e [mon decimal point] - 货币 小 数 点 符号 
e [mon thousands sep] - 货币 千 位 分 隔 符 
e [positive sign] - 正 值 符号 
e [negative sign] - 负 值 符号 
e [int frac digits] - 国际 小 数 数字 
。 [frac digits] - 本 地 小 数 数字 
e [p cs precedes] - if 如 果 货 币 符 号 在 正 值 之 前 ， 则 是 True (1)， 否 则 是 False (0). 
e [p sep by space]- True (1) 如 果 货 币 符号 与 正 值 之 间 有 空间 ， 则 是 True (1)， 否 则 是 
False (0)。 
e [n cs precedes] - True (1) if 货币 符号 在 负 值 之 前 ， 则 是 True (1)， 否 则 是 False (0)。 
e [p sep by space]- True (1) 如 果 货 币 符 号 与 负 值 之 间 有 空间 ， 则 是 True (1)， 否 则 是 
False (0)。 
e [p sign posn] - 格式 化 选项 : 
o 0 -在 数量 和 货币 符号 周围 的 圆 括号 
o 1- 数量 和 货币 符号 之 前 的 + 号 
o 2 -数量 和 货币 符号 之 后 的 + 号 
o 3 -货币 符号 之 前 的 + 号 
o 4- 货币 符号 之 后 的 + 号 
e [n sign posn] - 格式 化 选项 : 
o 0 -在 数量 和 货币 符号 周围 的 圆 括 号 
o 1 -数量 和 货币 符号 之 前 的 -号 
o 2 -数量 和 货币 符号 之 后 的 - 号 
o 3- 货币 符号 之 前 的 -号 
o 4- 货币 符号 之 后 的 -号 
e [grouping] - 显示 如 何 分 组 数字 的 Array (例如 : 3 指示 1 000 000) 
e [mon grouping] - 显示 如 何 分 组 货币 数字 的 Array (例如 : 2 指示 1 00 00 00) 


语法 


localeconv() 


提示 和 注释 


提示 : 如 需 定 义 本 地 设置 ， 请 使 用 setlocale() HR. 


例子 
在 本 例 中 ， 我 们 将 获得 美国 本 地 的 数字 格式 化 信息 : 


<?php 

setlocale(LC ALL, 'US'); 
$locale info = localeconv(); 
print r($locale info); 

?> 


输出 : 


Array 

( 

[decimal point] =>. 
[thousands sep] => , 
[int curr symbol] -» USD 
[currency symbol] => $ 
[mon decimal point] =>. 
[mon thousands sep] => , 
[positive sign] => 
[negative sign] => - 
[int frac digits] => 2 
[frac digits] => 2 

[p cs precedes] => 1 

[Pp sep by space] => 0 

[n cs precedes] => 1 

[n sep by space] => 0 

[p sign posn] => 3 

[n sign posn] => 0 
[grouping] -» Array ([0] -» 3) 
[mon grouping] => Array ([0] => 3) 
) 


PHP ltrim() 2X 

定义 和 用 法 

Itrim() 画 数 从 字符 串 左 侧 删 除 空格 或 其 他 预定 义 字符 。 
语法 


ltrim(string, charlist) 


参数 描述 
string 必需 。 规 定 要 转换 的 字符 串 。 


TÍ 
可 选 。 规 定 从 字符 串 中 删除 哪些 字符 。 如 果 未 设置 该 参数 ， 则 全 部 删除 以 下 字 
charlist 符 :"\o"-ASCIIONULL" \t"-ASCIl9, 制 表 符 " 4n "- ASCII 10, 新 行 
" xx0B " - ASCII 11, HB BUE RE" \r "- ASCII 13, 回 车 ” "- ASCII 32, 空格 


例子 
例子 1 


<html> 

<body> 

<?php 

HOLA Hello World!"; 

echo "Without ltrim: " . $str; 
echo "«br /»"; 

echo "With ltrim: " . ltrim($str), 
?» 

«body» 

«html» 


输出 : 


Without ltrim: Hello World! 
With ltrim: Hello World! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 以 下 HTML : 


<html> 
<body> 
Without ltrim: Hello World!<br />With ltrim: Hello World! 
«/body» 
«/html» 


例子 2 


<?php 
$str = "\r\nHello World!"; 
echo "Without ltrim: " . $str; 
echo "<br />"; 
echo "With ltrim: " . ltrim($str), 
?» 

输出 : 


Without ltrim: Hello World! 
With ltrim: Hello World! 


如 果 在 浏览 器 中 查看 源 代 码 ， 会 看 到 以 下 HTML : 


<html> 

<body> 

Without ltrim: 

Hello World!<br /»With ltrim: Hello World! 
«/body» 

«/html» 


+ 


PHP md5() 函数 


A 


定义 和 用 法 

md5() HUGHA FEI MD5 散 列 。 

md5() BAA RSA 数据 安全 ， 包 括 MDS 报 文 摘 译 算法 。 

如 果 成 功 ， 则 返回 所 计算 的 MD5 散 列 ， 如 果 失 败 ， 则 返回 false, 


语法 


md5( string , raw ) 





参数 描述 
string ， 必 需 。 规 定 要 计算 的 字符 串 。 


可 选 。 规 定 十 六 进 制 或 二 进 制 输出 格式 : TRUE -原始 16 字符 二 进 制 格式 


AA FALSE - 默认 。32 字符 十 六 进 制 数 注释 : 该 参数 是 PHP 5.0 中 添加 的 。 


例子 
例子 1 


<?php 

$str = "Hello"; 
echo md5($str); 
?> 


8b1a9953c4611296a827abf8c47804d7 


例子 2 


<?php 
$str - "Hello"; 
echo md5($str); 


if (md5($str) == '8b1a9953c4611296a827abf8c47804d7' ) 
echo "<br />Hello world!"; 
exit; 
} 
?» 
输出 : 


8b1a9953c4611296a827abf8c47804d7 
Hello world! 


PHP md5 file() 函数 


定义 和 用 法 

md5 file() KË GHANA MD5 散 列 。 

md5() HAHA RSA 数据 安全 ， 包 括 MDS 报 文 摘 译 算法 。 

如 果 成 功 ， 则 返回 所 计算 的 MD5 散 列 ， 如 果 失 败 ， 则 返回 false, 


语法 


md5( string , raw ) 





参数 描述 
string ”必需 。 规 定 要 计算 的 文件 。 


可 选 。 规 定 十 六 进 制 或 二 进 制 输出 格式 : TRUE -原始 16 字符 二 进 制 格 式 


AA FALSE - 默认 。32 字符 十 六 进 制 数 注释 : 该 参数 是 PHP 5.0 中 添加 的 。 


例子 
例子 1 


<?php 

$filename - "test.txt"; 
$md5file = md5 file($filename); 
echo $md5file; 

?» 


5d41402abc4b2a76b9719d911017c592 


例子 2 
存储 "test.txt" 文件 的 MD5 散 列 : 


<?php 

$md5file = md5 file("test.txt"); 

file put contents("md5file.txt", $md5file), 
?» 


在 本 例 中 ， 我 们 将 检测 "test.txt" 是 否 已 被 更 改 〈 即 是 否 MDS 散 列 已 被 更 改 ) 


<?php 
$md5file = file get contents("md5file.txt"); 
if (md5 file("test.txt") == $md5file) 

{ 


echo "The file is ok."; 
else 


echo "The file has been changed."; 


} 


?> 


输出 : 


The file is ok. 


= ~ N 
metaphone() Hit BF FFA metaphone ££. 
metaphone 键 字 符 串 的 英语 发 音 。 
metaphone() 函数 可 用 于 拼写 检查 应 用 程序 。 
| 返 


如 果 成 功 ， 则 返回 字符 串 的 metaphone 键 ， 如 果 失 败 ， 则 返回 false. 
语法 


metaphone(string, length) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 
length 可 选 。 规 定 metaphone 键 的 最 大 长 度 。 


提示 和 注释 


注释 : metaphone() 为 发 音 相似 的 单词 创建 相同 的 键 。 


注释 : 所 生成 的 metaphone ££ KE +. 
提示 : metaphone() 比 soundex() Ati, A4 metaphone() 了 解 基本 的 英语 发 音 规 


则 。 


例子 
例子 1 


<?php 
echo metaphone("world"); 
?> 

输出 : 


WRLT 


例子 2 
在 本 例 中 ， 我 们 对 两 个 发 音 相似 的 单词 应 用 metaphone() BR : 


<?php 
$str = "Sun", 
$str2 = "Son"; 


echo metaphone($str); 


echo metaphone($str2), 
?> 


输出 : 


SN 
SN 


PHP money format() 2% 
定义 和 用 法 

money format() 汞 数 把 字符 串 格 式 化 为 货币 字符 串 。 
语法 


money format(string, number ) 


参数 描述 
string 必需 。 规 定 要 格式 化 的 字符 串 。 
number 可 选 。 被 插入 格式 化 字符 串 中 % 符号 位 置 的 数字 。 


提示 和 注释 


注释 : money_format() HAA windows 平台 上 工作 。 


例子 
例子 1 


国际 en US 格式 : 


<?php 

$number = 1234.56; 

setlocale(LC MONETARY, "en US"), 

echo money format( "The price is %i", $number); 
?> 


输出 : 


The price is USD 1,234.56 


例子 2 
负数 ， 带 有 () 指示 负数 的 US 国际 格式 ， 右 侧 精度 为 2，"”" 为 填充 字符 : 


<?php 
$number = -1234.5672, 


echo money_format("%=*(#10.2n", $number); 
?> 


输出 : 


(Gee a T 2847 A) 


PHP nl langinfo() 函数 


定义 和 用 法 


nl langinfo() 画 数 返 回 指定 的 本 地 信息 。 


如 果 成 功 ， 则 返回 指定 的 本 地 信息 。 如 果 失 败 ， 则 返回 false. 


语法 


nl langinfo(element) 


参数 描述 


element 必 霜 。 规 定 要 返回 哪个 元 素 。 必 须 是 说 明 中 列 出 的 元 素 之 一 。 


说 明 


时 间 和 日 历 : 


ABDAY (1-7) - Abbreviated name of the numbered day of the week 

DAY (1-7) - Name of the numbered day of the week (DAY 1 = Sunday) 

ABMON (1-12) - Abbreviated name of the numbered month of the year 

MON (1-12) - Name of the numbered month of the year 

AM STR - String for Ante meridian 

PM STR - String for Post meridian 

D T FMT - String that can be used as the format string for strftime() to represent time 
and date 

D FMT - String that can be used as the format string for strftime() to represent date 

T FMT - String that can be used as the format string for strftime() to represent time 

T FMT AMPM - String that can be used as the format string for strftime() to represent 
time in 12-hour format with ante/post meridian 

ERA - Alternate era 

ERA YEAR - Year in alternate era format 

ERA D T FMT - Date and time in alternate era format (string can be used in strftime()) 
ERA D FMT - Date in alternate era format (string can be used in strftime()) 
ERA T FMT - Time in alternate era format (string can be used in strftime()) 


货币 类 别 : 


e INT CURR SYMBOL - Currency symbol (example: USD) 

e CURRENCY SYMBOL - Currency symbol (example: $) 

e CRNCYSTR - Same as CURRENCY SYMBOL 

e MON DECIMAL POINT - Monetary decimal point character 

e MON THOUSANDS SEP - Monetary thousands separator 

e POSITIVE SIGN - Positive value character 

e NEGATIVE SIGN -Negative value character 

e MON GROUPING - Array displaying how monetary numbers are grouped (example: 1 
000 000) 

e INT FRAC DIGITS - International fractional digits 

e FRAC DIGITS - Local fractional digits 

e P CS PRECEDES - True (1) if currency symbol is placed in front of a positive value, 
False (0) if it is placed behind 

e P SEP BY SPACE - True (1) if there is a spaces between the currency symbol and a 
positive value, False (0) otherwise 

e N CS PRECEDES - True (1) if currency symbol is placed in front of a negative value, 
False (0) if it is placed behind 

e N SEP BY SPACE - True (1) if there is a spaces between the currency symbol and a 
negative value, False (0) otherwise 


P SIGN POSN - Formatting setting. Possible return values: 
o 0- Parentheses surround the quantity and currency symbol 
o 1- The sign string is placed in front of the quantity and currency symbol 
o 2- The sign string is placed after the quantity and currency symbol 
o 3- The sign string is placed immediately in front of the currency symbol 


o 


4 - The sign string is placed immediately after the currency symbol 


N SIGN POSN - Formatting setting. Possible return values: 
o 0- Parentheses surround the quantity and currency symbol 
o 1- The sign string is placed in front of the quantity and currency symbol 


o 


2 - The sign string is placed after the quantity and currency symbol 
o 3- The sign string is placed immediately in front of the currency symbol 
o 4- The sign string is placed immediately after the currency symbol 


数字 类 别 : 


DECIMAL POINT - Decimal point character 

RADIXCHAR - Same as DECIMAL POINT 

THOUSANDS SEP - Separator character for thousands 

THOUSEP - Same as THOUSANDS SEP 

e GROUPING - Array displaying how numbers are grouped (example: 1 000 000) 


通信 类 别 : 


YESEXPR - Regex string for matching "yes! input 


NOEXPR - Regex string for matching 'no' input 
YESSTR - Output string for 'yes' 
NOSTR - Output string for 'no' 


代码 集 类 别 : 
e CODESET Return a string with the name of the character encoding. 
E 一 TP # 

提示 和 注释 

注释 : money format() HAA windows 平台 上 工作 。 


提示 : 与 返回 所 有 本 地 格式 化 信息 的 localeconv() BAA, nl langinfo() 返回 指定 的 信息 。 


PHP nl2br() 函数 


定义 和 用 法 


nl2br() 函数 在 字符 串 中 的 每 个 新 行 (\n) 之 前 插入 HTML 换行 符 (<br />)。 


语法 
nl2br(string) 
参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


例子 


<?php 
echo nl2br("One line.NnAnother line."); 
?> 


输出 : 


One line. 
Another line. 


HTML 代码 : 


One line.<br /> 
Another line. 


PHP number format() E32 
定义 和 用 法 

number format() HUM it FZ 43 28 RAG ALAS. 
语法 


number_format (number, decimals, decimalpoint, separator) 


参数 描述 
SEE 必需 。 要 格式 化 的 数字 。 如 果 未 设置 其 他 参数 ， 则 数字 会 被 格式 化 为 不 
带 小 数 点 且 以 喜 号 (,) 作为 分 隔 符 。 


| 可 选 。 规 定 多 少 个 小 数 。 如 果 设 置 了 该 参数 ， 则 使 用 点 号 (.) 作为 小 数 点 
AS 来 格式 化 数字 。 


decimalpoint ， 可 选 。 规 定 用 作 小 数 点 的 字符 串 。 


可 选 。 规 定 用 作 千 位 分 隔 符 的 字符 串 。 仅 使 用 该 参数 的 第 一 个 字符 。 上 比 
separator 如 "xyz" 仅 输 出 "x"。 注 释 : 如 果 设 置 了 该 参数 ， 那 么 所 有 其 他 参数 都 是 
必需 的 。 


提示 和 注释 


注释 : 该 画 数 支 持 一 个 、 两 个 或 四 个 参数 (不 是 三 个 ) 。 


例子 


<?php 

echo number format("1000000"); 

echo number format("1000000",2); 

echo number format(' 11000000", 2, ' M NUES 
?> 


输出 : 


1,000, 000 
1,000, 000.00 
1.000.000, 00 


PHP ord() 函数 


定义 和 用 法 


ord() 函数 返回 字符 串 第 一 个 字符 的 ASCII 值 。 


语法 
ord(string) 
参数 描述 
string 必需 。 要 从 中 获得 ASCII 值 的 字符 串 。 


例子 


<?php 

echo ord("h"); 
echo ord("hello"); 
?> 


输出 : 


104 
104 


PHP parse str() KŻ 
定义 和 用 法 

parse str() 函数 把 查询 字符 串 解析 到 变量 中 。 
语法 


parse_str(string,array) 


参数 描述 
string 必需 。 规 定 要 解析 的 字符 串 
array 可 选 。 规 定 存储 变量 的 数组 名 称 。 该 参数 指示 变量 存储 到 数组 中 


提示 和 注释 
注释 : 如 果 未 设置 array SR, MARBLES BERE CERERI E 


注释 : php.ini 中 的 magic_quotes_gpc 设置 影响 该 琅 数 的 输出 。 如 果 已 启用 ， 那 么 在 
parse str() 解析 之 前 ， 变 量 会 被 addslashes() 转换 。 


例子 
例子 1 


<?php 
parse_str("id=23&name=John%20Adams" ) ; 
echo $id."<br />"; 

echo $name; 

?> 


输出 : 


23 
John Adams 


例子 2 


<?php 


parse str("id-23&name-John?;:20Adams",$myArray); 
print r($myArray); 
?> 


输出 : 


Array 


[id] => 23 
[name] => John Adams 


) 


PHP print() 函数 
定义 和 用 法 

print() 沙 数 输出 一 个 或 多 个 字符 上 串 。 
语法 


print(strings) 


参数 描述 
strings 必需 。 发 送 到 输出 的 一 个 或 多 个 字符 串 。 


提示 和 注释 


注释 : print) 函数 实际 上 不 是 画 数 ， 所 以 您 不 必 对 它 使 用 括号 。 


Es] 


Es] 


注释 : print() KRIIS T echo()。 


例子 
例子 1 


<?php 

$str = "Who"s John Adams?", 

print $str, 

print "<br /»"; 

print $str."«br />I don't know!"; 
?> 


输出 : 


Who's John Adams? 
Who's John Adams? 
I don't know! 


例子 2 


<?php 

print "This text 
spans multiple 
lines." 

?> 


输出 : 


This text spans multiple lines. 


例子 3 


<?php 

$color - "red"; 

print "Roses are $color", 
print "«br /»"; 

print "Roses are $color'; 
?> 


输出 : 


Roses are red 
Roses are $color 


PHP printf() 西数 
定义 和 用 法 

printf() 本 数 输出 格式 化 的 字符 串 。 
语法 


printf(format,arg1,arg2,arg++) 


参数 描述 
format 必需 。 规 定 字符 串 以 及 如 何 格式 化 其 中 的 变量 。 
arg1 必需 。 规 定 插 到 格式 化 字符 串 中 第 一 个 % 符号 处 的 参数 。 
arg2 可 选 。 规 定 插 到 格式 化 字符 串 中 第 二 个 % 符号 处 的 参数 。 
arg++ 可 选 。 规 定 插 到 格式 化 字符 串 中 第 三 、 四 等 等 % 符号 处 的 参数 。 
说 明 


arg1, arg2, ++ 等 参数 将 插入 到 主 字 符 串 中 的 百 分 号 (%) 符号 处 。 该 落 数 是 逐步 执行 的 。 在 第 
一 个 % 符号 中 ， 插 入 arg1， 在 第 二 个 % RES A, A arg2， 依 此 类 推 。 


提示 和 注释 
注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 被 插入 % 符号 之 后 ， 由 数字 
和 "$" 组 成 。 请 参见 例子 3。 


注释 : THESE: fprintf()、 sprintf(), vfprintf()、 vprintf() 以 及 vsprintf()。 


例子 
例子 1 


<?php 

$str = "Hello", 

$number - 123; 

printf ("%s world. Day number %u",$str, $number), 
?> 


输出 : 


Hello world. Day number 123 


例子 2 


<?php 

$number - 123; 

printf ("Xf", $number); 
?> 


输出 : 


123.000000 


例子 3 
使 用 占 位 符 : 


<?php 

$number = 123, 

printf ("with 2 decimals: %1\$.2f<br />With no decimals: %1\$u", $number); 
?> 


输出 : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP quoted printable decode() 函数 


= ~ x 

quoted printable decode() 函数 对 经 过 quoted-printable 编码 后 的 字符 串 进 行 解码 ， 返 回 8 
位 的 字符 串 。 

该 函数 类 似 于 imap_qprint() 函数 。 不 同 的 是 ， 应 用 imap_qprint() 函数 需要 让 系统 加 载 IMAP 
iz, MANAG SIR IMAP 模块 。 


语法 


guoted printable decode(string) 


参数 描述 
string 必需 。 规 定 要 解码 的 quoted-printable FR., 


例子 


在 本 例 中 ， 应 用 quoted printable decode() 函数 对 经 过 quoted-printable 编码 后 的 字符 串 
"SOA" 进行 解码 ， 并 返回 8 位 的 字符 串 : 


<?php 

$str = "Hello=0Aworld."; 

echo guoted printable decode($str), 
?> 


输出 : 
Hello world. 


HTML 源 代 码 : 


Hello 
world. 


PHP quotemeta() HŽ% 


定义 和 用 法 


quotemeta() 函数 在 字符 串 中 某 些 预 定义 的 字符 前 添加 反 和 斜 杠 。 


一 
— 


e 
zc ME X A 
— a 
— 


do gd M 3 M 


quotemeta(string) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


提示 和 注释 


提示 : 该 函数 可 用 于 转 义 拥 有 特殊 意义 的 字符 ， 比 如 SQL 中 的 ()、[] AR * 


例子 


<?php 

$str = "Hello world. (can you hear me?)"; 
echo quotemeta($str); 

?> 


输出 : 


W3School PHP 参考 手册 


Hello world\. N(can you hear me\?\) 


PHP quotemeta() aX 823 


PHP rtrim() 函数 

定义 和 用 法 

chop() 函数 从 字符 串 的 末端 开始 删除 空白 字符 或 其 他 预定 义 字 符 。 
语法 


rtrim(string,charlist) 


参数 描述 
string 规定 要 转换 的 字符 串 。 


可 选 。 规 定 从 字符 串 中 删除 哪些 字符 。 如 果 未 设置 该 参数 ， 则 全 部 删除 以 下 字 


charlist 符 :"\o"-ASCIIONULL" \t " - ASCII 9, $UR" 4n "- ASCII 10, 新 行 
" xx6eB " - ASCII 11, 垂直 制 表 符 " vr "- ASCII 13, [p] +." 


例子 
在 本 例 中 ， 我 们 将 使 用 rrim) HAMPER GIR MOREE : 


<?php 

$str = "Hello World!\n\n"; 
echo $str; 

echo rtrim($str); 

?» 


以 上 代码 输出 的 源 代 码 : 


<html> 


<body> 
Hello World! 


Hello World!</body> 


</html> 


输出 : 


Hello World! Hello World! 


" - ASCII 32, 空格 


PHP setlocale() 函数 


= . N 

setlocale() 函数 设置 地 区 信息 (地 域 信息 ) 。 

地 区 信息 是 针对 一 个 地 理 区 域 的 语言 、 货 币 、 时 间 以 及 其 他 信息 。 
该 图 数 返回 当前 的 地 区 设置 ， 若 失败 则 返回 false. 

语法 


setlocale(constant, location) 


参数 描述 


必需 。 规 定 应 该 设置 什么 地 区 信息 。 可 用 的 常量 : LCALL -包括 下 面 的 所 
有 选项 Lc_coLLATE -排序 次 序 LC cTYPE - 字符 类 别 及 转换 (例如 所 有 字符 


constant 大 写 或 小 写 ) LC MESSAGES - 系统 消息 格式 LC MONETARY - 货币 格式 

LC NUMERIC - 数字 格式 Le TIME -日 期 /时 间 格 式 

必需 。 规 定 把 地 区 信息 设置 为 什么 国家 /地 区 。 如 果 location 参数 是 数组 ， 
Rectan setlocale() 会 党 试 每 个 数组 元 素 ， 直 到 找到 合法 的 语言 或 地 区 代码 为 止 。 如 


果 某 个 地 区 在 不 同 的 系统 上 拥有 不 同 的 名 称 ， 这 一 点 很 有 用 。 注 释 : TENES 
找 语言 和 地 区 代码 。 

提示 和 注释 

注释 : setlocale() 本 数 仅 针 对 当前 脚本 改变 地 区 信息 。 


提示 : 可 以 通过 setlocale(LC_ALL,NULL) 把 地 区 信息 设置 为 系统 默认 。 


例子 
在 本 例 中 ， 我 们 将 把 locale 设置 为 US English， 然 后 再 设置 回 系统 默认 : 


<?php 

echo setlocale(LC ALL, "En-Us"), 
echo setlocale(LC ALL,NULL), 

?> 


PHP sha1() 函数 


定义 和 用 法 

sha1() 函数 计算 字符 串 的 SHA-1 散 列 。 

sha1() AE HRE] Secure Hash 算法 1。 

如 果 成 功 ， 则 返回 所 计算 的 SHA-1 散 列 ， 如 果 失 败 ， 则 返回 false. 


语法 


sha1( string , raw ) 





参数 描述 
string ”必需 。 规 定 要 计算 的 字符 上 串 。 


可 选 。 规 定 十 六 进 制 或 二 进 制 输出 格式 : TRUE - 原始 20 字符 二 进 制 格式 


AA FALSE - EA. 40 字符 十 六 进 制 数 注释 : 该 参数 是 PHP 5.0 中 添加 的 。 


例子 
例子 1 


<?php 

$str = "Hello", 
echo shal($str), 
?> 


f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0 


例子 2 


在 本 例 中 ， 我 们 将 输出 shal) 的 结果 ， 然 后 对 其 测试 : 


<?php 
$str - "Hello", 
echo shal($str), 


if (shal($str) == 'f7ff9e8b7bb2e09b70935a5d785e0cc5d9dOabfe' ) 
echo "<br />Hello world!"; 
exit, 
} 
?» 
输出 : 


f7ff9e8b7bb2e09b70935a5d785e0cc5d9dOabfO 
Hello world! 


PHP sha1 file() 函数 


定义 和 用 法 
sha1 file() 汞 数 计算 文件 的 SHA-1 散 列 。 
sha1() 函数 使 用 美国 Secure Hash 算法 1。 


如 果 成 功 ， 则 返回 所 计算 的 SHA-1 散 列 ， 如 果 失 败 ， 则 返回 false, 
语法 


shal file( string , raw ) 





参数 描述 
string ”必需 。 规 定 要 计算 的 文件 。 


可 选 。 规 定 十 六 进 制 或 二 进 制 输出 格式 : TRUE -原始 20 字符 二 进 制 格 式 


AA FALSE - 默认 。40 字符 十 六 进 制 数 注释 : 该 参数 是 PHP 5.0 中 添加 的 。 


例子 
例子 1 


<?php 

$filename - "test.txt", 

$shaifile = shai_file($filename) ; 
echo $shaifile; 

?» 


输出 : 


aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d 


例子 2 
在 一 个 文件 中 存储 "test.txt" 的 SHA- 1 散 列 : 


<?php 

$shalfile - shal file("test.txt"); 

file put contents("shalfile.txt",$shalfile), 
?> 


在 本 例 中 ， 我 们 将 测试 "test.txt" 是 否 已 更 改 (Bl SHA-1 hash 是 否 已 更 改 ) 


<?php 
$shaifile = file get contents("shaifile.txt"); 
if (shal file("test.txt") == $shalfile) 


echo "The file is ok."; 
} 
else 
echo "The file has been changed.", 


} 


?> 


输出 : 


The file is ok. 


PHP similar text() 函数 


定义 和 用 法 
similar text() 函数 计算 两 个 字符 串 的 匹配 字符 的 数目 。 
该 贺 数 也 可 以 计算 两 个 字符 串 的 相似 度 (以 百分比 计 ) o 


similar text(stringi,string2,percent) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 
percent 可 选 。 规 定 供 存储 百分比 相似 度 的 变量 名 。 


提示 和 注释 


注释 : levenshtein() 函数 比 similar text() MAR, Ait, similar text() 函数 通过 更 少 的 必 
需 修改 次 数 提供 更 精确 的 结果 。 


例子 
例子 1 


<?php 
echo similar text("Hello World", "Hello Peter"); 
?> 


输出 : 


例子 2 


<?php 
similar text("Hello World", "Hello Peter", $percent), 


echo $percent, 
?» 


输出 : 


63.6363636364 


PHP soundex() Ea 


< 、 : 
soundex() it BF BAN soundex 键 。 

soundex 键 是 4 字符 长 的 字母 数字 字符 串 ， 表 示 一 个 单词 的 英文 发 音 。 
soundex() HAA AAFHS #4 aR. 

如 果 成 功 ， 则 返回 字符 串 的 soundex 键 ， 如 果 失 败 ， 则 返回 false, 
语法 


soundex(string) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 
提示 和 注释 


注释 : soundex() 为 发 音 相似 的 单词 创建 相同 的 键 。 


提示 : metaphone() 比 soundex() 函数 更 精确 ， 因 为 metaphone() 了 解 基本 的 英语 发 音 规 


则 。 


例子 
例子 1 


<?php 

$str = "hello", 
echo soundex($str), 
?> 


输出 : 


H400 


例子 2 


在 本 例 中 ， 我 们 对 两 个 发 音 相似 的 单词 应 用 soundex() HR : 


<?php 
$str = "Sun", 
$str2 - "Son"; 


echo soundex($str); 
echo "<br />"; 

echo soundex($str2); 
?> 


俞 出 : 


S500 
S500 


PHP sprintf() 函数 
定义 和 用 法 

sprintf() 函数 把 格式 化 的 字符 串 写 入 一 个 变量 中 。 
语法 


sprintf( format , argl , arg2 , arg++ ) 





参数 描述 
format 必需 。 转 换 格式 。 
arg1 必需 。 规 定 插 到 format 字符 串 中 第 一 个 % 符号 处 的 参数 。 
arg2 可 选 。 规 定 插 到 format 字符 串 中 第 二 个 % 符号 处 的 参数 。 


arg++ 可 选 。 规 定 插 到 format 字符 串 中 第 三 、 四 等 等 % 符号 处 的 参数 。 


说 明 


参数 format 是 转换 的 格式 ， 以 百分比 符号 ("%") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
值 : 


e %% - 返回 百分比 符号 

e %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

。 %d - 带 符 号 十 进 制 数 

e %e - 可 续 计数 法 (比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e %f - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e %o - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 

e %X - TRAIRA (ASFA) 


arg1, arg2, ++ 等 参数 将 插入 到 主 字符 串 中 的 百 分 号 (%) 符号 处 。 该 落 数 是 逐步 执行 的 。 在 第 
一 个 % 符号 中 ， 插 入 arg1， 在 第 二 个 % RES A, A arg2， 依 此 类 推 。 


提示 和 注释 


注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 插 到 % 符号 后 面 ， 由 数字 和 
"$" 组 成 。 请 参见 例子 3。 


提示 : HR : fprintf), printf()、 vfprintf()、 vprintf() 以 及 vsprintf()。 


例子 
例子 1 


<?php 

$str = "Hello"; 

$number = 123, 

$txt = sprintf("%s world. Day number %u", $str, $number ); 
echo $txt; 

?> 


Hello world. Day number 123 


例子 2 


<?php 

$number - 123; 

$txt = sprintf("%F", $number); 
echo $txt; 

?> 


123.000000 


例子 3 


<?php 

$number = 123; 

$txt = sprintf("With 2 decimals: %1\$.2f<br />with no decimals: %1X$u", $number); 
echo $txt; 

?> 


输出 : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP sscanf() KŻ 


定义 和 用 法 

sscanf() 函数 根据 指定 的 格式 解析 来 自 一 个 字符 串 的 输入 。 

如 果 只 向 该 加 数 传递 两 个 参数 ， 数 据 将 以 数组 的 形式 返回 。 否 则 ， 如 果 传 递 了 额外 的 参数 ， 
那么 被 解析 的 数据 会 存储 在 这 些 参数 中 。 如 果 区 分 符 的 数目 大 于 包含 它们 的 变量 的 数目 ， 则 
会 发 生 错误 。 不 过 ， 如 果 区 分 符 少 于 变量 ， 则 额外 的 变量 包含 NULL。 


语法 


sscanf(string,format,arg1,arg2,arg++) 


参数 描述 
string 必需 。 规 定 要 读 取 的 字符 串 。 
format 必需 。 规 定 要 使 用 的 格式 。 
arg1 可 选 。 存 储 数据 的 第 一 个 变量 。 
arg2 可 选 。 存 储 数据 的 第 二 个 变量 。 
arg++ 可 选 。 存 储 数据 的 第 三 、 四 个 变量 。 依 此 类 推 。 
说 明 


参数 format 是 转换 的 格式 ， 以 百分比 符号 ("96") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
值 : 


e 9696 - 返回 百分比 符号 

。 %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

。 %d - 带 符号 十 进 制 数 

e %e - 可 续 计数 法 (比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e %f - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e %o - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 


e %X -十 六 进 制 数 (大 写字 母 ) 


例子 


<?php 

$string = "age:30 weight:60kg"; 

sscanf ($string, "age:%d weight :%dkg", $age, $weight); 
// show types and values 

var dump($age, $weight ); 

?> 


输出 : 


int(30) 
int(60) 


PHP str ireplace() Ea 
定义 和 用 法 

str ireplace() 函数 使 用 一 个 字符 串 替 换 字符 串 中 的 另 一 些 字符 。 
语法 


str ireplace(find, replace, string, count) 


参数 描述 
find 必需 。 规 定 要 查找 的 值 。 
replace 必需 。 规 定 蔡 换 find 中 的 值 的 值 。 
string 必需 。 规 定 被 搜索 的 字符 串 。 
count 可 选 。 一 个 变量 ， 对 替换 数 进行 计数 。 


提示 和 注释 

注释 : 该 贺 数 对 大 小 写 不 敏感 。 请 使 用 str replace() 执行 对 大 小 写 敏 感 的 搜索 。 
注释 : 该 函数 是 二 进 制 安全 的 。 

例子 

例子 1 


<?php 
echo str ireplace("world", "John", "Hello world!"), 
?> 


输出 : 


Hello John! 


例子 2 


在 本 例 中， 我们 将 演示 带 有 数组 和 count 变量 的 str ireplace() HR : 


<?php 

$arr = array("blue", "red", "green", "yellow"); 
print r(str ireplace("red", "pink", $arr,$i)); 
echo "Replacements: $i"; 

?> 


输出 : 


Array 

( 

[0] => blue 
[1] => pink 


[2] => green 
[3] => yellow 
) 


Replacements: 1 


PIF 3 


<?php 
$find = array("Hello","world"); 
$replace = array("B"); 


$arr = array("Hello","world","!"); 
print r(str ireplace($find, $replace, $arr)); 
?> 


Array 

( 

[0] => B 
[1] => 
[2] => ! 


PHP str pad() 函数 


定义 和 用 法 


str_pad() 函数 把 字符 串 填 充 为 指定 的 长 度 。 


语法 


str pad(string, length, pad string, pad type) 


参数 


string 
length 


pad string 


pad type 


例子 
例子 1 


<?php 


描述 
必需 。 规 定 要 填充 的 字符 串 。 
必需 。 规 定 新 字符 串 的 长 度 。 如 果 该 值 小 于 原始 字符 串 的 长 度 ， 则 不 进行 
任何 操作 。 
可 选 。 规 定 供 填充 使 用 的 字符 串 。 默 认 是 空白 。 


可 选 。 规 定 填充 字符 串 的 那 边 。 可 能 的 值 : STR_PAD_BoTH - 填充 到 字符 串 
的 两 头 。 如 果 不 是 偶数 ， 则 右 侧 获得 额外 的 填充 。 STR_PAD_LEFT - 填充 到 
字符 串 的 左 侧 。 STR_PAD_RIGHT - 填充 到 字符 串 的 右 侧 。 这 是 默认 的 。 





$str = "Hello World", 
echo str pad($str,20,"."); 


?> 


输出 : 


Hello World 


例子 2 


<?php 


$str - "Hello World"; 
echo str pad($str,20,".", STR PAD LEFT); 


2» 


DU LE AE Hello World 


«?php 
$str - "Hello World", 
echo str pad($str,20,".:", STR PAD BOTH); 
?» 
输出 : 


„1. 1Hello World.:.:. 


PHP str repeat() HŽ% 
定义 和 用 法 

str repeat() 函数 把 字符 串 重 复 指 定 的 次 数 。 
语法 


str repeat(string,repeat) 


参数 描述 
string 必需 。 规 定 要 重复 的 字符 串 。 
repeat 必需 。 规 定 字符 串 将 被 重复 的 次 数 。 必 须 大 于 等 于 0。 


例子 


<?php 
echo str repeat(".",13); 
?> 


PHP str replace() 函数 
定义 和 用 法 

str replace() 函数 使 用 一 个 字符 串 蔡 换 字 符 串 中 的 另 一 些 字 符 。 
语法 


str_replace( find, replace, string, count) 


参数 描述 
find 必需 。 规 定 要 查找 的 值 。 
replace 必需 。 规 定 蔡 换 find 中 的 值 的 值 。 
string 必需 。 规 定 被 搜索 的 字符 串 。 
count 可 选 。 一 个 变量 ， 对 替换 数 进行 计数 。 


提示 和 注释 
注释 : 该 贺 数 对 大 小 写 敏感 。 请 使 用 str ireplace() 执行 对 大 小 写 不 敏感 的 搜索 。 


注释 : 该 函数 是 二 进 制 安全 的 。 
例子 
例子 1 


<?php 
echo str replace("world","John","Hello world!"); 
?> 


输出 : 


Hello John! 


例子 2 


在 本 例 中， 我 们 将 演示 带 有 数组 和 count 变量 的 str replace() HR : 


<?php 

$arr = array("blue", "red", "green", "yellow"); 
print r(str replace("red", "pink", $arr,$i)): 
echo "Replacements: $i"; 

?> 


输出 : 


Array 

( 

[0] => blue 
[1] => pink 


[2] => green 
[3] => yellow 
) 


Replacements: 1 


PIF 3 


<?php 
$find = array("Hello","world"); 
$replace = array("B"); 


$arr = array("Hello","world","!"); 
print_r(str_replace($find, $replace, $arr) ); 
?> 


Array 

( 

[0] => B 
[1] => 
[2] => ! 


PHP str rot13() 函数 


ra. : 
定义 和 用 法 
str_rot13() 画 数 对 字符 串 执 行 ROT13 编码 。 


ROT-13 编码 是 一 种 每 一 个 字母 被 另 一 个 字母 代 蔡 的 方法 。 这 个 代替 字母 是 由 原来 的 字母 向 前 
移动 13 个 字母 而 得 到 的 。 数 字 和 非 字 母 字符 保持 不 变 。 


BS 
语法 
str rot13(string) 


参数 描述 
string 必需 。 规 定 要 编码 的 字符 串 。 


提示 和 注释 
提示 : 编码 和 解码 都 是 由 相同 的 函数 完成 的 。 如 果 您 把 一 个 已 编码 的 字符 串 作 为 参数 ， 那 么 
将 返回 原始 字符 串 。 


例子 
在 本 例 中 ， 我 们 将 通过 使 用 str rot13() 函数 对 字符 串 进行 编码 和 解码 : 


<?php 

echo str rot13("Hello World"), 
echo "<br /»"; 

echo str roti3("Uryyb Jbeyq"); 
?> 


输出 : 


Uryyb Jbeyd 
Hello World 


PHP str shuffle() 函数 
定义 和 用 法 

str shuffle() 本 数 随机 地 打 乱 字符 串 中 的 所 有 字符 。 
语法 


str shuffle(string) 


string 必需 。 规 定 要 打 乱 的 字符 串 。 


例子 


<?php 
echo str shuffle( "Hello World"), 
?» 


输出 : 


H eloowlrdl 


PHP str split() 函数 
定义 和 用 法 

str split() 函数 把 字符 串 分 割 到 数组 中 。 
语法 


str split(string, length) 


参数 描述 
string 必需 。 规 定 要 分 割 的 字符 串 。 
length 可 选 。 规 定 每 个 数组 元 素 的 长 度 。 默 认 是 1。 


说 明 
如 果 length 小 于 1，str_split() FABYIKIEI false. 


如 果 length 大 于 字符 串 的 长 度 ， 整 个 字符 串 将 作为 数组 的 唯一 元 素 返 回 。 


例子 
例子 1 


<?php 
print r(str split("Hello")); 
?» 


— 
N 
uw 
Il 
v 
OHH 0 — 


例子 2 


<?php 


print r(str split("Hello",3)); 
?> 


输出 : 
Array 
( 
[0] => Hel 
[1] -> 1o 


PHP str word count() 函数 
定义 和 用 法 
str word count() 函数 计算 字符 串 中 的 单词 数 。 
语法 
str word count(string,return,char) 


参数 描述 
string ”必需 。 规 定 要 检查 的 字符 串 。 


可 选 。 规 定 str word count() 函数 的 返回 值 。 可 能 的 值 : o - 默认 。 返 回 找到 
return ”的 单词 的 数目 。 1 - 返回 包含 字符 串 中 的 单词 的 数组 。 2 - 返回 一 个 数组 ， 
其 中 的 键 是 单词 在 字符 串 中 的 位 置 ， 值 是 实际 的 单词 。 


return ”可 选 。 规 定 被 认定 为 单词 的 特殊 字符 。 该 参数 是 PHP 5.1 中 新 加 的 。 


例子 
例子 1 


<?php 
echo str word count("Hello world!"), 
?> 


输出 : 


例子 2 


<?php 
print r(str word count("Hello world!",1)); 
?> 


输出 : 


Array 

( 

[0] => Hello 
[1] => world 
) 


例子 3 


<?php 
print r(str word count("Hello world!",2)); 
?> 


输出 : 


Array 

( 

[0] -» Hello 
[6] => world 
) 


例子 4 


<?php 

print_r(str_word_count("Hello world & good morning!",1)); 
print_r(str_word_count("Hello world & good morning!",1,"&")); 
?> 


输出 : 
Array 
( 
[0] => Hello 
[1] => world 
[2] => good 
[3] => morning 
) 
Array 
( 
[0] => Hello 
[1] => world 
[2] => & 
[3] => good 


[4] => morning 


PHP strcasecmp() HŽ% 


[m x 
strcasecmp() PR2 EG & A DFA. 
该 函数 返回 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0- 如 果 string1 大 于 string2 


语法 


strcasecmp(stringi,string2) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 


提示 和 注释 


注释 : 该 图 数 是 二 进 制 安 全 的 ， 且 对 大 小 写 不 敏感 。 


例子 


<?php 
echo strcasecmp( "Hello world!", "HELLO WORLD!"), 
?> 


输出 : 


PHP strchr() EX 


定义 和 用 法 

strchr() 本 数 搜索 一 个 字符 串 在 另 一 个 字符 串 中 的 第 一 次 出 现 。 

该 范 数 返回 字符 串 的 其 余部 分 〈 从 匹配 点 ) 。 如 果 未 找到 所 搜索 的 字符 串 ， 则 返回 false, 
该 函数 是 strstr() 西数 的 别名 。 


语法 


strchr(string, search) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
nup: 规定 所 搜索 的 字符 串 。 如 果 该 参数 是 数字 ， 则 搜索 匹配 数字 ASCII 值 的 
字符 。 
提示 和 注释 
注释 : 该 函数 是 二 进 制 安全 的 。 
注释 : 该 图 数 对 大 小 写 敏 感 。 如 需 进 行 大 小 写 不 敏感 的 搜索 ， 请 使 用 stristr()。 


例子 
例子 1 


<?php 
echo strchr("Hello world!","world"); 
?> 


输出 : 


world! 


例子 2 


在 本 例 中 ， 我 们 将 搜索 "o" BY ASCII 值 所 代表 的 字符 : 


<?php 
echo strchr("Hello world!",111); 
?> 


输出 : 


o world! 


PHP strcmp() HŽ 


定义 和 用 法 


strcmp() NAb ASE. 


3X ES [B] 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0- 如 果 string1 大 于 string2 


语法 


strcmp(string1, string2) 


参数 
string1 
string2 


提示 和 注释 
注释 : ŽIANEZ 


例子 


<?php 


echo strcmp("Hello world!", "Hello world!"); 
?> 


输出 : 


规定 要 比较 的 第 一 
规定 要 比较 的 第 二 


描述 
个 字符 串 。 
个 字符 串 。 


进 制 安全 的 ， 且 对 大 小 写 敏 感 。 


PHP strcoll() E325 


mo. N 
strcoll() ES2& Eb d ADRE, 
ji Eg UR [n] 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0 - 如 果 string1 大 于 string2 


字符 串 的 比较 会 根据 本 地 设置 而 变化 。 (A<a 或 A>a) 。 
语法 


strcoll(string1, string2) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 


提示 和 注释 
注释 : 该 画 数 对 大 小 写 敏感 ， 但 不 是 二 进 制 安全 的 。 
注释 : 如 果 本 地 设置 是 C 或 POSIX， 则 该 画 数 的 工作 方式 与 stremp() 相同 。 


例子 


<?php 

setlocale (LC COLLATE, "NL" A 

echo strcoll("Hello World!", "Hello WORLD!"); 
echo "<br /»"; 


setlocale (LC COLLATE, "en US") 


echo strcoll("Hello World!", "Hello WORLD!"); 
?> 


输出 : 


W3School PHP 参考 手册 


PHP strcoll() EG 857 


PHP strcspn() 函数 

定义 和 用 法 

strcspn() 本 数 返回 在 找到 任何 指定 的 字符 之 前 ， 在 字符 串 查找 的 字符 数 。 
语法 


strcspn(string, char, start, length) 


参数 描述 

string 必需 。 规 定 要 搜索 的 字符 串 。 

char 必需 。 规 定 要 查找 的 字符 。 

start 可 选 。 规 定 开始 查找 的 位 置 。 该 参数 是 PHP 4.3 中 新 加 的 。 

length ， 可 选 。 规 定 字符 串 的 长 度 〈 搜 索 多 少 字符 ) 。 该 参数 是 PHP 4.3 中 新 加 的 。 


提示 和 注释 


注释 : 该 图 数 是 二 进 制 安全 的 。 


例子 


<?php 
echo strcspn("Hello world!","w"); 
?> 


输出 : 


PHP strip tags() 2 
定义 和 用 法 

strip tags() 函数 剥 去 HTML, XML 以 及 PHP 的 标签 。 
语法 


strip tags(string,allow) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 
allow 可 选 。 规 定 允 许 的 标签 。 这 些 标签 不 会 被 删除 。 


提示 和 注释 

注释 : ŽABA A AXE HTML 注释 。 这 点 无 法 通过 allow 参数 改变 。 
例子 

例子 1 


<?php 
echo strip_tags("Hello <b>world!</b>"); 
?> 


输出 : 


Hello world! 


例子 2 


<?php 
echo strip tags("Hello <b><i>world!</i></b>","<b>"); 
?> 


输出 : 


W3School PHP 参考 手册 


Hello **world!** 


PHP strip tags() 函数 860 


PHP stripcslashes() HŽ% 
定义 和 用 法 

stripcslashes() 函数 删除 由 addcslashes() 函数 添加 的 反 斜 杠 。 
语法 


stripcslashes(string) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


提示 和 注释 
注释 : 该 画 数 用 于 清理 从 数据 库 中 取 回 的 数据 。 
例子 


<?php 
echo stripcslashes("Hello, \my na\me is Kai Ji\m."); 
?> 


输出 : 


Hello, my name is Kai Jim. 


PHP stripslashes() E32 
定义 和 用 法 

stripslashes() 函数 删除 由 addslashes() KARIRI RRL. 
语法 


stripslashes(string) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


提示 和 注释 
注释 : 该 画 数 用 于 清理 从 数据 库 或 HTML. 表单 中 取 回 的 数据 。 
例子 


<?php 
echo stripslashes("Who\'s John Adams?"), 
?> 


输出 : 


Who's John Adams? 


PHP stripos() HŽ% 


定义 和 用 法 
stripos() 函数 返回 字符 串 在 另 一 个 字符 串 中 第 一 次 出 现 的 位 置 。 


如 果 没 有 找到 该 字符 串 ， 则 返回 false. 


stripos(string, find, start) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
find 必需 。 规 定 要 查找 的 字符 。 
start 可 选 。 规 定 开始 搜索 的 位 置 。 


E — Mrs 
提示 和 注释 
注释 : 该 函数 对 大 小 写 不 敏感 。 如 需 进 行 对 大 小 写 敏 感 的 搜索 ， 请 使 用 strpos() HR, 


例子 


<?php 
echo stripos("Hello world!","wo"); 
?> 


输出 : 


PHP stristr() 函数 


定义 和 用 法 
stristr() 函数 查找 字符 串 在 另 一 个 字符 串 中 第 一 次 出 现 的 位 置 。 
如 果 成 功 ， 则 返回 字符 串 的 其 余部 分 (从 匹配 点 ) 。 如 果 没 有 找到 该 字符 串 ， 则 返回 false, 


参数 描述 
string 必需。 规定 被 搜索 的 字符 串 。 


必需 。 规 定 要 查找 的 字符 。 如 果 该 参数 是 数字 ， 则 搜索 匹配 该 数字 对 应 的 ASCII 
值 的 字符 。 


提示 和 注释 
注释 : 该 图 数 是 二 进 制 安 全 的 。 


释 : 该 图 数 对 大 小 写 不 敏感 。 如 需 对 大 小 写 敏感 的 搜索 ， 请 使 用 strstr()。 


NAP 
n 


例子 
例子 1 


<?php 
echo stristr("Hello world!", WORLD"); 
?> 


输出 : 


world! 


例子 2 


<?php 
echo stristr("Hello world!", 111), 
?> 


输出 : 


o world! 


PHP strlen() 函数 
定义 和 用 法 
strlen() HZUR FRB KE. 
语法 

strlen(string) 


BR 


string 必需 。 规 定 要 检查 的 字符 串 。 


例子 


<?php 
echo strlen("Hello world!"); 
?> 


输出 : 


12 


+ 


PHP strnatcasecmp() Až 


A 


定义 和 用 法 
strnatcasecmp() 函数 使 用 一 种 “自然 "算法 来 比较 两 个 字符 串 。 


在 自然 算法 中 ， 数 字 "2" 小 于 数字 "10"。 在 计算 机 排序 中 ，"2" 大 于 "10"， 这 是 因为 "2" 大 于 
"10" 的 第 一 个 数字 。 


AWARE : 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0 - 如 果 string1 大 于 string2 


语法 


strnatcasecmp(string1, string2) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 


提示 和 注释 


注释 : 该 图 数 对 大 小 写 不 敏感 。 


例子 


<?php 

echo strnatcasecmp("2Hello world!","10Hello world!"); 
echo "«br /»"; 

echo strnatcasecmp("10Hello world!","2Hello world!"); 
?> 


输出 : 


W3School PHP 参考 手册 


PHP strnatcasecmp() ES 868 


PHP strnatcmp() HŽ% 


定义 和 用 法 
strnatcmp() 函数 使 用 一 种 “自然 "算法 来 比较 两 个 字符 串 。 


在 自然 算法 中 ， 数 字 "2" 小 于 数字 "10"。 在 计算 机 排序 中 ，"2" 大 于 "10"， 这 是 因为 "2" 大 于 
"10" 的 第 一 个 数字 。 


AWARE : 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0 - 如 果 string1 大 于 string2 


语法 


strnatcmp(string1, string2) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 


提示 和 注释 


注释 : 该 图 数 对 大 小 写 敏感 。 


例子 


<?php 

echo strnatcmp("2Hello world!", "10Hello world!"); 
echo "<br />"; 

echo strnatcmp("10Hello world!","2Hello world!"); 
?> 


输出 : 


-1 
1 


W3School PHP 参考 手册 


PHP strnatcmp() 函数 870 


PHP strncasecmp() Ex 


rm . ` 
定义 和 用 法 
strncasecmp() ER2X EG A DF Be 


ZB] 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0- 如 果 string1 大 于 string2 


语法 


strncasecmp(stringi, string2, length) 


效 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 
length 必需 。 规 定 每 个 字符 串 用 于 比较 的 字符 数 。 


提示 和 注释 


注释 : ARAE 


例子 


<?php 
echo strncasecmp("Hello world!", 
?» 


输出 : 


进 制 安全 的 ， 且 对 大 小 写 不 敏感 。 


"Hello earth!",6); 


PHP strncmp() HŽ% 


rm . ` 
strncmp() 函数 比较 两 个 字符 串 。 
该 函数 返回 


。 0 - 如 果 两 个 字符 串 相 等 
e «0 - 如 果 string1 小 于 string2 
e >0- 如 果 string1 大 于 string2 


语法 


strncmp(string1, string2, length) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 
length 必需 。 规 定 每 个 字符 串 用 于 比较 的 字符 数 。 


提示 和 注释 


注释 : 该 图 数 是 二 进 制 安全 的 ， 且 对 大 小 写 敏感 。 


例子 


<?php 


echo strncmp("Hello world!", "Hello earth!", 
?> 


输出 : 


6); 


PHP strpbrk() EX 


定义 和 用 法 
strpbrk() 画 数 在 字符 串 中 搜索 指定 字符 中 的 任意 一 个 。 
该 函数 返回 指定 字符 第 一 次 出 现 的 位 置 开 始 的 剩余 部 分 。 如 果 没 有 找到 ， 则 返回 false, 


语法 


strpbrk(string, charlist) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
charlist 必需 。 规 定 要 查找 的 字符 。 


提示 和 注释 


注释 : 该 图 数 对 大 小 写 敏感 。 


例子 


<?php 
echo strpbrk("Hello world!","oe"); 
?> 


输出 : 


ello world! 


PHP strpos() 2X 


定义 和 用 法 
strpos() 函数 返回 字符 串 在 另 一 个 字符 串 中 第 一 次 出 现 的 位 置 。 


如 果 没 有 找到 该 字符 串 ， 则 返回 false. 


strpos(string, find, start) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
find 必需 。 规 定 要 查找 的 字符 。 
start 可 选 。 规 定 开始 搜索 的 位 置 。 


B—31n e 
提示 和 LESE 
注释 : 该 图 数 对 大 小 写 敏感 。 如 需 进 行 对 大 小 写 不 敏感 的 搜索 ， 请 使 用 stripos() HH 


例子 


<?php 
echo strpos("Hello world!","wo"); 
?> 


输出 : 


PHP strrchr() E325 


定义 和 用 法 


strrchr() 图 数 查 找 字 符 串 在 另 一 个 字符 串 中 最 后 一 次 出 现 的 位 置 ， 并 返回 从 该 位 置 到 字符 串 结 
尾 的 所 有 字符 。 


如 果 成 失败 ， 否 则 返回 false. 
语法 


strrchr(string,char) 


参数 描述 
string ”必需 。 规 定 被 搜索 的 字符 串 。 
ee ME 规定 要 查找 的 字符 。 如 果 该 参数 是 数字 ， 则 搜索 匹配 数字 ASCI AHS 


提示 和 注释 

注释 ARAE AREN, 
例子 

例子 1 


<?php 
echo strrchr("Hello world!","world"); 
?» 


world! 


例子 2 


<?php 
echo strrchr("Hello world!", 111), 
?> 


输出 : 


orld! 


PHP strrev() 函数 
定义 和 用 法 
strrev() 函数 反 转 字符 串 。 
语法 
strrev(string) 


参数 


string 必需 。 规 定 要 反 转 的 字符 串 。 


例子 


<?php 
echo strrev("Hello World!"), 
?> 


输出 : 


!dlrow olleH 


PHP strripos() 2 


定义 和 用 法 
strripos() 本 数 查找 字符 串 在 另 一 个 字符 串 中 最 后 一 次 出 现 的 位 置 。 


如 果 成 功 ， 则 返回 位 置 ， 否 则 返回 false。 


strrpos(string, find, start) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
find 必需 。 规 定 要 查找 的 字符 。 
start 可 选 。 规 定 开始 搜索 的 位 置 。 


提示 和 注释 


注释 : 该 图 数 对 大 小 写 不 敏感 。 如 需 进行 大 小 写 敏感 的 查找 ， 请 使 用 strrpos()。 


例子 


<?php 
echo strripos("Hello world!", "WO"); 
?> 


输出 : 


PHP strrpos() 2X 


定义 和 用 法 
strrpos() 画 数 查找 字符 串 在 另 一 个 字符 串 中 最 后 一 次 出 现 的 位 置 。 


如 果 成 功 ， 则 返回 位 置 ， 否 则 返回 false, 


strrpos(string, find, start) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
find 必需 。 规 定 要 查找 的 字符 。 
start 可 选 。 规 定 开始 搜索 的 位 置 。 


提示 和 注释 


注释 : 该 函数 对 大 小 写 敏 感 。 如 需 进 行 大 小 宇 不 敏感 的 查找 ， 请 使 用 strripos()。 


例子 


<?php 
echo strrpos("Hello world!","wo"); 
?> 


输出 : 


PHP strspn() 2X 
定义 和 用 法 

strspn() 画 数 返回 在 字符 串 中 包含 的 特定 字符 的 数目 。 
语法 


strspn(string, charlist, start, length) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
charlist 必需 。 规 定 要 查找 的 字符 。 
start 可 选 。 规 定 在 字符 串 的 何 处 开始 。 
length 可 选 。 规 定 字符 串 的 长 度 。 





提示 和 注释 

注释 : 该 图 数 是 二 进 制 安 全 的 。 
例子 

例子 1 


<?php 
echo strspn("Hello world!","kHlleo"); 
?> 


输出 : 


<?php 
echo strspn("abcdefand","abc"); 
?> 


输出 : 


PHP strstr() E32 


定义 和 用 法 
strstr() 画 数 搜索 一 个 字符 串 在 另 一 个 字符 串 中 的 第 一 次 出 现 。 
该 函数 返回 字符 串 的 其 余部 分 (从 匹配 点 ) 。 如 果 未 找到 所 搜索 的 字符 串 ， 则 返回 false. 


strstr(string, search) 


参数 描述 
string 必需 。 规 定 被 搜索 的 字符 串 。 
Ws. MEF 


M" 搜索 的 字符 串 。 如 果 该 参数 是 数字 ， 则 搜索 匹配 数字 ASCII 值 的 
字符 


提示 和 注释 
注释 : 该 画 数 是 二 进 制 安全 的 。 
注释 : 该 画 数 对 大 小 写 敏感 。 如 需 进 行 大 小 写 不 敏感 的 搜索 ， 请 使 用 stristr()。 


例子 
例子 1 


<?php 
echo strstr("Hello world!","world"); 
?> 


输出 : 


world! 


例子 2 


在 本 例 中 ， 我 们 将 搜索 "o" BY ASCII 值 所 代表 的 字符 : 


<?php 
echo strstr("Hello world!",111); 
?> 


输出 : 


o world! 


PHP strtok() 函数 
定义 和 用 法 

strtok() 范 数 把 字符 串 分 割 为 更 小 的 字符 串 。 
语法 


strtok(string, split) 


参数 描述 
string 必需 。 规 定 要 分 割 的 字符 串 。 
split 必需 。 规 定 一 个 或 多 个 分 割 字符 。 


例子 


在 下 面 的 例子 中 ， 请 注意 ， 我 们 仅 在 第 一 次 调用 strtok() 函数 时 使 用 了 string 参数 。 在 首次 调 
用 后 ， 该 图 数 仅 需要 split 参数 ， 这 是 因为 它 清楚 自己 在 当前 函数 中 所 在 的 位 置 : 


<?php 

$string = "Hello world. Beautiful day today."; 
$token = strtok($string, " "); 

while ($token !== false) 


echo "$token<br />", 
$token - strtok(" "); 
} 


2» 


输出 : 


Hello 
world. 
Beautiful 
day 
today. 


PHP strtolower() HŽ% 
定义 和 用 法 

strtolower() 函数 把 字符 串 转 换 为 小 写 。 
语法 


strtolower(string) 


string 必需 。 规 定 要 转换 的 字符 串 。 


例子 


<?php 
echo strtolower("Hello WORLD!"); 
?» 


输出 : 


hello world! 


PHP strtoupper() Až 


定义 和 用 法 


strtoupper() HAF BRAKE. 


语法 
strtoupper(string) 
参数 
string 必需 。 规 定 要 转换 的 字符 串 。 


例子 


<?php 
echo strtoupper("Hello WORLD!"), 
?> 


输出 : 


HELLO WORLD! 


PHP strtr() Až 
定义 和 用 法 
strtr() 画 数 转换 字符 串 中 特定 的 字符 。 
语法 

strtr(string, from, to) 


或 者 


strtr(string,array) 


参数 描述 

string] ”必需 。 规 定 要 转换 的 字符 串 。 

from 必需 (除非 使 用 数组 ) 。 规 定 要 改变 的 字符 。 

to 必需 (除非 使 用 数组 ) 。 规 定 要 改变 为 的 字符 。 

st (除非 使 用 from 和 to) 。 一 个 数组 ， 其 中 的 键 是 原始 字符 ， 值 是 目标 字 
说 明 


如 果 from 和 to 的 长 度 不 同 ， 则 格式 化 为 最 短 的 长 度 。 


例子 
例子 1 


<?php 
echo strtr("Hilla Warld","ia","eo"), 
?» 


输出 : 


Hello World 


例子 2 


<?php 

$arr = array("Hello" => "Hi", "world" => "earth"); 
echo strtr("Hello world",$arr); 

?> 


输出 : 


HI earth 


PHP substr() 2X 
定义 和 用 法 

substr() 函数 返回 字符 串 的 一 部 分 。 
语法 


substr( string , start , length ) 





参数 描述 
string ”必需 。 规 定 要 返回 其 中 一 部 分 的 字符 上 串 。 


必需 。 规 定 在 字符 串 的 何 处 开始 。 EX - 在 字符 串 的 指定 位 置 开 始 负数 -在 
从 字符 串 结尾 的 指定 位 置 开 始 o - 在 字符 串 中 的 第 一 个 字符 处 开始 


length ”可 选 。 规 定 要 返回 的 字符 串 关 度 。 默 认 是 直到 字符 串 的 结尾 。 EA -M star 
参数 所 在 的 位 置 返回 au - 从 字符 串 未 端 返回 


start 


提示 和 注释 

注释 : 如 果 start 是 负数 且 length 小 于 等 于 start, w) length 为 0。 
例子 

例子 1 


<?php 
echo substr("Hello world!",6), 
?> 


输出 : 


world! 


例子 2 


<?php 
echo substr("Hello world!",6,5); 
?» 


输出 : 


world 


PHP substr compare() E325 


ch. S 

定义 和 用 法 

substr compare() 函数 从 指定 的 开始 长 度 比较 两 个 字符 上 串 。 
该 贺 数 返回 


e 0 - 如 果 两 字符 串 相等 
e <0 - 如 果 string1 〈 从 开始 位 置 ) 小 于 string2 
。 >0 - 如 果 string] 〈 从 开始 位 置 ) 大 于 string2 


语法 


substr compare(string1, string2, startpos, length, case) 


参数 描述 
string1 必需 。 规 定 要 比较 的 第 一 个 字符 串 。 
string2 必需 。 规 定 要 比较 的 第 二 个 字符 串 。 
startpos 可 选 。 规 定 在 string? 中 的 何 处 开始 比较 。 
length Wit, MEE string? 中 参与 比较 的 字符 数 。 
case 可 选 。 规 定 是 否 指 定 大 小 写 比较 。 默 认 是 FALSE (对 大 小 写 敏感 ) 。 


说 明 

如 果 length 大 于 或 等 于 string1 的 状 度 ， 则 函数 返回 false. 
例子 

例子 1 


<?php 
echo substr compare("Hello world", "Hello world",0); 
?> 


输出 : 


例子 2 


<?php 
echo substr compare("Hello world", "world",6), 
?> 


输出 : 


例子 3 


<?php 
echo substr compare("Hello world", "WORLD", 6, TRUE), 
?» 


输出 : 


PHP substr count() HŽ% 
定义 和 用 法 

substr count() 函数 计算 子 串 在 字符 串 中 出 现 的 次 数 。 
语法 


substr count( string , substring , start , length ) 











参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 
substring 必需 。 规 定 要 检索 的 字符 串 。 
start 可 选 。 规 定 在 字符 串 中 何 处 开始 搜索 。 
length 可 选 。 规 定 搜索 的 长 度 。 


例子 


<?php 
echo substr count("Hello world. The world is nice", "world"), 
?» 


输出 : 


PHP substr replace() ižť 
定义 和 用 法 

substr replace() 函数 把 字符 串 的 一 部 分 替换 为 另 一 个 字符 串 。 
语法 


substr replace(string, replacement, start, length) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


replacement 必需。 规定 要 插入 的 字符 串 。 
必需 。 规 定 在 字符 串 的 何 处 开始 替换 。 正 数 - 在 第 start 个 偏 移 量 开始 
start 替换 负数 - 在 从 字符 串 结尾 的 第 start 个 偏 移 量 开始 替换 o - 在 字符 串 
中 的 第 一 个 字符 处 开始 替换 


可 选 。 规 定 要 替换 多 少 个 字符 。 EX - 被 蔡 换 的 字符 串 长 度 负数 -M 
字符 串 末 端 开始 的 被 替换 字符 数 o - HAMÉ K 


charlist 


提示 和 注释 


注释 : 如 果 start 是 负数 且 length | F$ start, M] length 4 0. 


例子 


<?php 
echo substr replace("Hello world", "earth",6), 
?> 


输出 : 


Hello earth 


PHP trim() 函数 


rm . 2 
trim() 函数 从 字符 串 的 两 端 删 除 空白 字符 和 其 他 预定 义 字 符 。 
语法 


trim(string,charlist) 


参数 描述 
string 必需 。 规 定 要 检查 的 字符 串 。 


可 选 。 规 定 要 转换 的 字符 串 。 如 果 省 略 该 参数 ， 则 删除 以 下 所 有 字符 : "x0" 
charlist -NULL" \t "- tab" ^n "- newline" \xoB " - 纵向 列表 符 " Nc "- 回 车 ” "- 
普通 空白 字符 


例子 
例子 1 


<html> 

<body> 

<?php 

$str = " Hello World! ee 
echo "Without trim: " . $str; 
echo "«br /»"; 

echo "With trim: " . trim($str); 


«body» 
<html> 


俞 出 : 


Without trim: Hello World! 
With trim: Hello World! 


HTML 源码 : 


<html> 
<body> 
Without trim: Hello World! <br />with trim: Hello World! 
</body> 
«/html» 


例子 2 


<?php 
$str = "\r\nHello World!\r\n"; 
echo "Without trim: " . $str; 
echo "<br />"; 
echo "With trim: " . trim($str); 
?» 

输出 : 


Without trim: Hello World! 
With trim: Hello World! 


HTML 源码 : 


<html> 

<body> 

Without trim: 

Hello World! 

<br />With trim: Hello World! 
</body> 

</html> 


PHP ucfirst() 函数 
定义 和 用 法 

ucfirst() 函数 把 字符 串 中 的 首 字符 转换 为 大 写 。 
语法 


ucfirst(string) 


string 必需 。 规 定 要 转换 的 字符 串 。 


例子 


<?php 
echo ucfirst("hello world"), 
?» 


输出 : 


Hello world 


PHP ucwords() E25 


定义 和 用 法 


ucwords() 豆 数 把 字符 串 中 每 个 单词 的 首 字符 转换 为 大 写 。 


语法 


ucwords(string) 


string 必需 。 规 定 要 转换 的 字符 串 。 


例子 


<?php 
echo ucwords("hello world"); 
?» 


输出 : 


Hello World 


PHP vfprintf() 西数 


定义 和 用 法 
vfprintf() 范 数 把 格式 化 的 字符 串 写 到 指定 的 输出 流 。 


与 fprintf() 不 同 ，vfprintf() 中 的 arg 参数 位 于 数组 中 。 数 组 的 元 素 会 被 插入 主 字符 串 的 百分比 
(%) 符号 处 。 该 本 数 是 逐步 执行 的 。 在 第 一 个 % 符号 中 ， 插 入 arg1， 在 第 二 个 % AS, 
插入 arg2， 依 此 类 推 。 


ARARIRE PTR KE. 
语法 


vfprintf(stream,format,argarray) 


[cid 


参数 fü 
stream 必需 。 规 定 在 何 处 写 / 输 出 字符 串 。 
format 必需 。 转 换 格式 。 
带 有 参数 的 一 个 数组 ， 这 些 参 数 会 被 插 到 format 字符 串 中 的 % 符号 


o 


argarray 


说 明 
参数 format 是 转换 的 格式 ， 以 百分比 符号 ("96") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
值 : 


e 9696 - 返回 百分比 符号 

。 %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

。 %d - 带 符号 十 进 制 数 

e %e - 可 续 计数 法 (上 比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e %f - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e No - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 


。 %X -十 六 进 制 数 (大 写字 母 ) 


提示 和 注释 


注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 插 到 % 符号 后 面 ， 由 数字 和 
"$" 组 成 。 请 参见 例子 3. 


提示 : 相关 图 数 : fprintf()、 printf()、 sprintf), vprintf() 以 及 vsprintf()。 


例子 
例子 1 


<?php 

$str = "Hello"; 

$number = 123, 

$txt = sprintf("%s world. Day number %u", $str, $number); 
echo $txt; 

?> 


Hello world. Day number 123 


例子 2 


<?php 

$number - 123; 

$txt = sprintf("%F", $number); 
echo $txt; 

?> 


123.000000 


PIF 3 


«?php 

$number - 123; 

$txt = sprintf("With 2 decimals: %1\$.2f<br />With no decimals: %1\$u", $number), 
echo $txt; 

?> 


输出 : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP vprintf() 函数 


定义 和 用 法 
vprintf() 画 数 输出 格式 化 的 字符 串 。 


与 printf() 不 同 ，vprintf() 中 的 arg 参数 位 于 数组 中 。 数 组 的 元 素 会 被 插入 主 字符 串 的 百分比 
(96) 符号 处 。 该 琅 数 是 逐步 执行 的 。 在 第 一 个 % 符号 中 ， 插 入 arg1， 在 第 二 个 % 符号 处 ， 
插入 arg2， 依 此 类 推 。 


vprintf(format,argarray) 


参数 fü 
format 必需 。 转 换 格式 。 
必需 。 带 有 参数 的 一 个 数组 ， 这 些 参数 会 被 插 到 format 字符 串 中 的 % 符号 
处 


o 


BE 


argarray 


pt BH 
参数 format 是 转换 的 格式 ， 以 百分比 符号 ("96") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
fü : 


e 9696 - 返回 百分比 符号 

。 %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

e %d - 带 符号 十 进 制 数 

e %e - 可 续 计数 法 (上 比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e Yf - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e 950 - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 

e %X - Psie (ASFA) 


提示 和 注释 
注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 插 到 % 符号 后 面 ， 由 数字 和 
"$" 组 成 。 请 参见 例子 3。 


提示 : HR : fprintf), printf()、 sprintf), vfprintf() 以 及 vsprintf()。 


例子 
例子 1 


<?php 

$str - "Hello"; 

$number - 123; 

vprintf("%s world. Day number %u",array($str, $number ) ); 
?> 


Hello world. Day number 123 


例子 2 


<?php 

$num1 - 123; 

$num2 - 456; 

vprintf("4FXf", array($num1, $num2) ); 
?> 


123.000000456. 000000 


例子 3 
使 用 占 位 符 : 


<?php 

$number = 123, 

vprintf("With 2 decimals: %1\$.2f<br />With no decimals: %1X$u",array($number)), 
?> 


输出 : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP vsprintf() 2X 


定义 和 用 法 
vsprintf() 范 数 把 格式 化 字符 串 写 入 变量 中 。 


与 sprintf() 不 同 ，vsprintf() 中 的 arg 参数 位 于 数组 中 。 数 组 的 元 素 会 被 插入 主 字符 串 的 百 分 
kb (%) 符号 处。 该 函数 是 逐步 执行 的 。 在 第 一 个 % 符号 中 ， 插 入 arg1， 在 第 二 个 % 符号 
处 ， 揪 入 arg2， 依 此 类 推 。 


vsprintf(format,argarray) 


参数 fü 
format 必需 。 转 换 格式 。 
必需 。 带 有 参数 的 一 个 数组 ， 这 些 参数 会 被 插 到 format 字符 串 中 的 % 符号 
处 


o 


BE 


argarray 


说 明 


参数 format 是 转换 的 格式 ， 以 百分比 符号 ("96") 开始 到 转换 字符 结束 。 下 面 的 可 能 的 format 
fü : 


e 9696 - 返回 百分比 符号 

。 %b - 二 进 制 数 

e %c - 依照 ASCII 值 的 字符 

e %d - 带 符号 十 进 制 数 

e %e - 可 续 计数 法 (上 比如 1.5e+3) 
e %u - 无 符号 十 进 制 数 

e Yf - 浮 点 数 (local settings aware) 
e %F - 浮 点 数 (not local settings aware) 
e 950 - 八进制 数 

e %s - 字符 串 

e %x - 十 六 进 制 数 〈 小 写字 母 ) 

e %X - Psie (ASFA) 


提示 和 注释 


注释 : 如 果 % 符号 多 于 arg 参数 ， 则 您 必须 使 用 占 位 符 。 占 位 符 插 到 % 符号 后 面 ， 由 数字 和 
"$" 组 成 。 请 参见 例子 3。 


提示 : AXK : fprintf()、 printf()、 sprintf), vfprintf() 以 及 vprintf()。 


例子 
例子 1 


<?php 

$str = "Hello", 

$number - 123; 

$txt = vsprintf("%s world. Day number %u",array($str, $number) ); 
echo $txt; 

?> 


Hello world. Day number 123 


例子 2 


<?php 
$num1 - 123; 
$num2 = 456; 
$txt = vsprintf("%F%F", array($num1, $num2)); 
echo $txt; 
?> 
输出 : 


123.000000456.000000 


例子 3 
使 用 占 位 符 : 


<?php 

$number = 123, 

$txt = vsprintf("With 2 decimals: %1\$.2f 

<br />With no decimals: %1X$u",array($number)), 
echo $txt; 

?> 


输出 : 


With 2 decimals: 123.00 
With no decimals: 123 


PHP wordwrap() E325 


re. : 
wordwrap() 函数 按照 指定 长 度 对 字符 串 进行 折 行 处 理 。 


如 果 成 功 ， 则 返回 折 行 后 的 字符 串 。 如 果 失 败 ， 则 返回 false。 
语法 


wordwrap(string,width, break, cut) 





参数 描述 

string ”必需 。 规 定 要 进行 折 行 的 字符 串 。 

width ”可 选 。 规 定 最 大 行 宽度 。 默 认 是 75。 

break ， 可 选 。 规 定 作为 分 隔 符 使 用 的 字符 〈 字 串 断 开 字 符 ) 。 默 认 是 N", 

cut 可 选 。 规 定 是 否 对 大 约 指定 宽度 的 单词 进行 折 行 。 默 认 是 FALSE (no-wrap)。 


例子 
例子 1 


<?php 

$str = "An example on a long word is: Supercalifragulistic"; 
echo wordwrap($str, 15), 

?> 


浏览 器 输出 : 


An example on a long word is: Supercalifragulistic 


HTML 源 代 码 : 


<html> 

<body> 

An example on a 

long word is: 
Supercalifragulistic 
</body> 

</html> 


例子 2 


<?php 

$str - "An example on a long word is: Supercalifragulistic"; 
echo wordwrap($str,15, "<br />\n"); 

?> 


输出 : 


An example on a 
long word is: 
Supercalifragulistic 


PIF 3 


<?php 

$str = "An example on a long word is: Supercalifragulistic"; 
echo wordwrap($str,15,"<br />\n", TRUE); 

?> 


输出 : 


An example on a 
long word is: 
Supercalifragul 
istic 


PHP XML Parser IZ 


PHP XML Parser 简介 


XML Egi e zE3 ARAT XML 文档 ， 但 无 法 对 其 进行 验证 。 


XML 是 一 种 用 于 标准 结构 化 文档 交换 的 数据 格式 。 您 可 以 在 我 们 的 XML 教程 中 找到 更 多 有 
关 XML 的 信息 。 


该 扩展 使 用 Expat XML 解析 器 。 


Expat 是 一 种 基于 事件 的 解析 器 ， 它 把 XML 文档 视 为 一 系列 事件 。 当 某 个 事件 发 生 时 ， 它 调 
用 一 个 指定 的 范 数 处 理 它 。 


Expat 是 无 验证 的 解析 器 ， 忽 略 任何 链接 到 文档 的 DTD。 但 是 ， 如 果 文 档 的 形式 不 好 ， 则 会 
以 一 个 错误 消息 结束 。 


由 于 它 基于 事件 ， 且 无 验证 ，Expat 具有 快速 并 适合 web 应 用 程序 的 特性 。 
XML 解析 器 函数 允许 我 们 创建 XML 解析 器 ， 并 为 XML 事件 定义 句柄 。 
Jay 


安装 


XML ae PHP 核心 的 组 成 部 分 。 无 需 安 装 即 可 使 用 这 些 画 数 。 


PHP XML Parser 函数 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


W3School PHP 参考 手册 


画 数 描述 FRE 
把 UTF-8 字符 串 解码 为 ISO- 
utf8 decode() 8859-1. 3 
把 ISO-8859-1 字符 串 编 码 为 
utf8 encode() UTF-8, 3 
xml error string() 获取 XML 解析 器 的 错误 描述 。 3 
xml get current byte index() s XML 解析 器 的 当前 字 节 索 2 
xml get current column number() 获取 XML 解析 器 的 当前 列 号 。 3 
xml get current line number() 获取 XML 解析 器 的 当前 行 号 。 3 
xml get error code() 获取 XML 解析 器 错误 代码 。 3 
xml_parse() 解析 XML 文档 。 3 
xml parse into struct() 把 XML 数据 解析 到 数组 中 。 3 
AZ UU, + Z 
xml parser create ns() s 1654525 JA CIBO XML 8 4 
xml parser create() 创建 XML 解析 器 。 3 
xml parser free() 释放 XML 解析 器 。 3 
WE 从 XML 解析 器 获取 选项 设置 信 3 
xml parser set option() 为 XML 解析 进行 选项 设置 。 3 
xml set character data handler() 建立 字符 数据 义理 器 。 3 
xml set default handler() 建立 默认 的 数据 处 理 器 。 3 
xml set element handler() 建立 起 始 和 终止 元 素 处 理 器 。 3 
xml set end namespace decl handler) ”建立 终止 命名 空间 声明 人 处理 器 。 4 
xml set external entity ref handler() 建立 外 部 实体 义理 器 。 3 
xml set notation decl handler() 建立 注释 声明 处 理 器 。 3 
xml set object() 在 对 象 中 使 用 XML 解析 器 。 4 
xml set processing instruction handler() ”建立 处 理 指 合 (Pl) «#225. 3 
xml set start namespace decl handler) ， 建立 起 始 命名 空间 声明 义理 器 。 4 
xml set unparsed entity decl handler() 建立 未 解析 实体 定义 声明 处 理 器 。 3 


PHP XML Parser 音量 


PHP XML Parser Až 911 


Constant 
XML ERROR NONE (integer) 
XML ERROR NO MEMORY (integer) 
XML ERROR SYNTAX (integer) 
XML ERROR NO ELEMENTS (integer) 
XML ERROR INVALID TOKEN (integer) 
XML ERROR UNCLOSED TOKEN (integer) 
XML ERROR PARTIAL CHAR (integer) 
XML ERROR TAG MISMATCH (integer) 
XML ERROR DUPLICATE ATTRIBUTE (integer) 
XML ERROR JUNK AFTER DOC ELEMENT (integer) 
XML ERROR PARAM ENTITY REF (integer) 
XML ERROR UNDEFINED ENTITY (integer) 
XML ERROR RECURSIVE ENTITY REF (integer) 
XML ERROR ASYNC ENTITY (integer) 
XML ERROR BAD CHAR REF (integer) 
XML ERROR BINARY ENTITY REF (integer) 
XML ERROR ATTRIBUTE EXTERNAL ENTITY REF (integer) 
XML ERROR MISPLACED XML PI (integer) 
XML ERROR UNKNOWN ENCODING (integer) 
XML ERROR INCORRECT ENCODING (integer) 
XML ERROR UNCLOSED CDATA SECTION (integer) 
XML ERROR EXTERNAL ENTITY HANDLING (integer) 
XML OPTION CASE FOLDING (integer) 
XML OPTION TARGET ENCODING (integer) 
XML OPTION SKIP TAGSTART (integer) 
XML OPTION SKIP WHITE (integer) 


PHP utf8 decode() 函数 


mo. N 
utf8 decode() 画 数 把 UTF-8 字符 串 解 码 为 ISO-8859-1, 

该 图 数 把 用 UTF-8 方式 编码 的 ISO-8859-1 字符 串 转 换 成 单字 节 的 ISO-8859-1 字符 串 。 
如 果 成 功 ， 该 范 数 将 返回 解码 字符 串 ; 否则 返回 false, 

语法 


utf8 decode(string) 


参数 描述 
string 必需 。 规 定 要 解码 的 字符 串 。 


PHP utf8 encode() HŽ 


m. S 
定义 和 用 法 
utf8 encode() 函数 把 ISO-8859-1 字符 串 编码 为 UTF-8。 


Unicode 是 全 球 标 准 ， 已 经 发 展 到 能 够 通过 唯一 的 编码 来 描述 所 有 语言 中 的 字符 ， 外 加 大 量 
的 符号 。 


， 并 不 是 总 能 可 靠 地 在 计算 机 之 间 传 递 Unicode 字符 。UTF-8 可 用 于 在 计算 机 之 间 传 输 
feda 字符 。 


如 果 成 功 ， 该 画 数 将 返回 编码 字符 串 ; 否则 返回 false, 
语法 
utf8 encode(string) 


参数 描述 
定 要 编码 的 字符 串 。 


string 


PHP xml error string() 函数 
定义 和 用 法 

xml error string() 函数 获取 XML 解析 器 的 错误 描述 。 
语法 


xml error string(errorcode) 


参数 描述 
PREK ah 规定 要 使 用 的 错误 代码 。 该 错误 码 是 xml get error code() 函数 的 返 


说 明 


返回 与 errorcode 描述 的 错误 代码 参数 对 应 的 文本 描述 字符 串 ， 若 没有 与 之 对 应 的 描述 ， 则 返 
回 false。 


例子 


<?php 
// 无 效 的 xml 文件 
$xmlfile = 'test.xml'; 


$xmlparser - xml parser create(); 


// open a file and read data 
$fp - fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096)) 
{ 
// parse the data chunk 
if (!xml parse($xmlparser, $xmldata, feof ($fp) )) 


die( print "ERROR: " 
. xml error string(xml get error code($xmlparser)) 
NU Dr T/S 
ime s 
. xml get current line number($xmlparser) 
. "<br /»" 
. "Column: " 
. xml get current column number($xmlparser) 
A kia Zle 
} 
} 


xml parser free($xmlparser); 
?> 


输出 : 


ERROR: Mismatched tag 
Line: 8 
Column: 51 


PHP xml get current byte index() HŽ% 
定义 和 用 法 
xml get current byte index() 函数 获取 XML 解析 器 的 当前 字 节 索引 。 
语法 
xml get current byte index(parser) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 


说 明 


如 果 parser 没有 指向 一 个 合法 的 解析 器 ， 该 图 数 将 返回 false， 否 则 将 返回 解析 器 当前 在 其 数 
据 缓 冲 区 中 的 字 节 索引 (起 始 值 为 0) 。 


例子 


<?ph 
// 无 效 的 xml 文件 
$xmlfile = 'test.xml'; 


$xmlparser - xml parser create(); 


// 打开 文件 并 读 取 数 据 
$fp = fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096)) 


// parse the data chunk 
if (!xml parse($xmlparser, $xmldata, feof($fp))) 


ae print "ERROR: " 
xml_error_string(xml_get_error_code($xmlparser ) ) 
Nebr For 

sine: 

. xml get current line number($xmlparser) 
"cbr Fan 

. "Column: " 

. xml get current column number($xmlparser) 
"cbr Tan 

. "Byte Index: " 

. xml get current byte index($xmlparser) 

1 "cbr /»"); 

} 


J 


xml parser free($xmlparser); 
?> 


输出 : 


ERROR: Mismatched tag 
Line: 8 

Column: 51 

Byte Index: 96 


PHP xml get current line number() 2 
定义 和 用 法 

xml get current line number() ižš jk HN XML 解析 器 的 当前 行 号 。 

语法 


xml get current line number(parser) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 


说 明 


如 果 parser 参数 没有 指向 一 个 合法 的 解析 器 ， 该 琅 数 将 返回 FALSE， 人 否则 将 返回 指定 解析 器 
在 其 缓存 中 的 当前 行 号 。 


例子 


<?php 
// 无 效 xml 文件 
$xmlfile = 'test.xml'; 


$xmlparser - xml parser create(); 


// 打开 文件 并 读 取 数 据 
$fp = fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096)) 
{ 
// parse the data chunk 
if (!xml parse($xmlparser, $xmldata, feof($fp))) 


die( print "ERROR: " 
. xml error string(xml get error code($xmlparser)) 
7 "<br > 
a: iba H 
. xml get current line number ($xmlparser) 
7 "<br /»" 
. "Column: " 
. xml get current column number($xmlparser) 
A "<br /»"); 
J 
} 


xml parser free($xmlparser); 
?> 
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输出 : 
ERROR: Mismatched tag 
Line: 8 
Column: 61 


PHP xml get current line number() 函数 920 


PHP xml get error code() 2X 


= ~ ~ 
xml get error code() 函数 获取 XML 解析 器 错误 代码 。 


如 果 成 功 ， 则 返回 错误 代码 。 否 则 ， 返 回 false. 
语法 


xml get error code(parser) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 


例子 


<?php 
// 无 效 的 xml 文件 
$xmlfile = 'test.xml'; 


$xmlparser - xml parser create(); 


// 打开 文件 并 读 取 数 据 
$fp = fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096)) 
{ 
// parse the data chunk 
if (!xml parse($xmlparser, $xmldata, feof ($fp) )) 


die( print "ERROR: " 
. xml get error code($xmlparser) 
7 "<br /»" 
"Eines 
. xml get current line number($xmlparser) 
g "<br /»" 
. "Column: " 
. xml get current column number ($xmlparser ) 
` "<br /»"); 
J 
d 


xml parser free($xmlparser); 
?> 


输出 : 
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ERROR: 76 
Line: 8 
Column: 61 


PHP xml get error code() MŽ 922 


PHP xml parse() 2% 


= ~ N 

xml parse() 函数 解析 XML 文档 。 

如 果 成 功 ， 则 返回 true. AN, RE false, 
语法 


xml parse(parser, xml, end) 


2 描述 

要 使 用 的 XML 解析 器 。 

需 。 规 定 要 解析 的 XML 数据 。 

end 可 选 。 如 果 该 参数 是 true， 则 xml 参数 中 的 数据 为 当前 解析 中 最 后 一 段 数据 。 


parser ”必需 。 规 定 
xml NS 定 


提示 和 注释 


提示 : 要 创建 XML 解析 器 ， 请 使 用 <a href="" title "xml parser create()</a> 西数 。 


例子 


<?ph 
// 无 效 的 xml 文件 
$xmlfile = 'test.xml'; 


$xmlparser - xml parser create(); 


// 打开 文件 并 读 取 数 据 
$fp = fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096)) 


// parse the data chunk 
if (!xml parse($xmlparser, $xmldata, feof($fp))) 


ae print "ERROR: " 
xml get error code($xmlparser) 


"cbr Fan 
a. Mines 
. xml get current line number ($xmlparser) 
"<br Fon 
. "Column: " 
. xml_get_current_column_number ($xmlparser ) 
a Teale EN 
J 
J 
xml parser free($xmlparser); 
?» 
输出 : 
ERROR: 76 
Line: 8 


Column: 61 


PHP xml parse into struct() Až 


定义 和 用 法 
xml parse into struct() 函数 把 XML 数据 解析 到 数组 中 。 
AAA XML 数据 解析 到 2 个 数组 中 : 


e Value 数组 - 包含 来 自 被 解析 的 XML 的 数据 
e Index 数组 - 包含 指向 Value 数组 中 值 的 位 置 的 指针 


如 果 成 功 ， 则 该 范 数 返 回 1。 否 则 返回 0。 
语法 


xml parse into struct(parser, xml,value arr,index arr) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
xml 必需 。 规 定 要 解析 的 XML 数据 。 
value arr 必需 。 规 定 XML 数据 的 目标 数组 。 
index_arr 可 选 。 规 定 index 数据 的 目标 数组 。 





提示 和 注释 


注释 : xml parse into struct() 若 失败 返回 0， 成 功 则 返回 1。 这 和 false 5 true 不 同 ， 使 用 
例如 === 运算 符 时 要 注意 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding="IS0-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting! </body> 
</note> 


PHP 代码 : 


<?php 

// 无 效 xml 文件 

$xmlfile = 'test.xml'; 

$xmlparser - xml parser create(); 


// 打开 文件 并 读 取 数 据 
$fp = fopen($xmlfile, 'r'); 
$xmldata = fread($fp, 4096), 


xml parse into struct($xmlparser, $xmldata, $values), 


xml parser free($xmlparser); 
print r($values), 
?> 


输出 : 


Array 
( 
[0] => Array 
( 
[tag] => NOTE 
[type] => open 
[level] => 1 
[value] => 
) 
[1] => Array 
( 
[tag] => TO 
[type] => complete 
[level] => 2 
[value] => George 
) 
[2] => Array 
( 
[tag] => NOTE 
[value] => 
[type] => cdata 
[level] => 1 
) 
[3] => Array 
( 
[tag] => FROM 
[type] => complete 
[level] => 2 
[value] => John 
) 
[4] => Array 
( 
[tag] => NOTE 
[value] => 
[type] => cdata 
[level] => 1 
) 
[5] => Array 
( 
[tag] => HEADING 
[type] => complete 
[level] => 2 
[value] => Reminder 
) 
[6] => Array 
( 
[tag] => NOTE 
[value] => 


[type] => cdata 
[level] => 1 
) 
[7] => Array 
( 
[tag] => BODY 
[type] => complete 
[level] => 2 
[value] => Don't forget the meeting! 
) 
[8] => Array 
( 
[tag] => NOTE 
[value] => 
[type] => cdata 
[level] => 1 
) 
[9] => Array 
( 
[tag] => NOTE 
[type] => close 
[level] => 1 
) 
) 


PHP xml parser create ns() E2X 


c. : 
定义 和 用 法 

xml parser create ns() 画 数 创建 带 有 命名 空间 支持 的 XML 解析 器 。 

该 图 数 建立 一 个 新 的 XML 解析 器 并 返回 可 被 其 它 XML 画 数 使 用 的 资源 句柄 。 


xml parser create ns(encoding, separator) 





参数 描述 
encoding 可 选 。 规 定 输出 编码 。 
encoding 可 选 。 规 定 标签 名 和 命名 空间 的 输出 分 隔 符 。 黑 认 是 ":"。 


说 明 
可 选 参数 encoding 在 PHP 4 中 用 来 指定 要 被 解析 的 XML 输入 的 字符 编码 方式 。 


PHP 5 开始 ， 自 动 侦 测 输入 的 XML 的 编码 ， 因 此 encoding 参数 仅 用 来 指定 解析 后 输出 数据 
的 编码 。 


TE PHP 4 中 ， 默 认输 出 的 编码 与 输入 数据 的 编码 是 相同 的 。 如 果 传 递 了 空 字 符 串 ， 解 析 器 会 
尝试 搜索 头 3 或 4 个 字 节 以 确定 文档 的 编码 。 


在 PHP 5.0.0 和 5.0.1 中 ， 默 认输 出 的 字符 编码 是 ISO-8859-1， 而 PHP 5.0.2 及 以 上 版 本 是 
UTF-8。 


解析 器 支持 的 编码 有 ISO-8859-1, UTF-8 和 US-ASCII. 


提示 和 注释 
提示 : 要 释放 XML 解析 器 ， 请 使 用 xml parser free() AŽ. 


提示 : 要 创建 没有 命名 空间 支持 的 XML 解析 器 ， 请 使 用 xml parser create() Až. 


例子 


<?php 
$xmlparser - xml parser create ns(); 





xml parser free($xmlparser); 
?> 


PHP xml parser create() 2% 


定义 和 用 法 
xml parser create() 26) XML 解析 器 。 


该 图 数 建立 一 个 新 的 XML 解析 器 并 返回 可 被 其 它 XML ES csi A BJ 4 EJ A 


xml parser create(encoding) 


参数 描述 


encoding 可 选 。 规 定 输出 编码 。 


说 明 
可 选 参数 encoding 在 PHP 4 中 用 来 指定 要 被 解析 的 XML 输入 的 字符 编码 方式 。 


PHP 5 开始 ， 自 动 侦 测 输 入 的 XML 的 编码 ， 因 此 encoding 参数 仅 用 来 指定 解析 后 输出 数据 
的 编码 。 


ft PHP 4 中 ， 默 认输 出 的 编码 与 输入 数据 的 编码 是 相同 的 。 如 果 传 递 了 空 字 符 串 ， 解 析 器 会 
尝试 搜索 头 3 或 4 个 字 节 以 确定 文档 的 编码 。 


在 PHP 5.0.0 和 5.0.1 中 ， 默 认输 出 的 字符 编码 是 1SO-8859-1， 而 PHP 5.0.2 及 以 上 版 本 是 
UTF-8。 


解析 器 支持 的 编码 有 ISO-8859-1, UTF-8 和 US-ASCII. 


提示 和 注释 
提示 : 要 释放 XML 解析 器 ， 请 使 用 xml parser free() WRX. 


提示 : 要 创建 带 有 命名 空间 支持 的 XML 解析 器 ， 请 使 用 xml parser create ns() HX. 





例子 


<?php 
$xmlparser - xml parser create(); 


xml parser free($xmlparser); 
?> 


PHP xml parser free() 函数 


定义 和 用 法 


xml parser free() 函数 释放 XML 解析 器 。 


如 果 成 功 ， 则 返回 true。 否 则 返回 false. 


语法 


xml parser free(parser) 


参数 


parser 必需 。 规 


提示 和 注释 


要 释放 的 XML 解析 器 。 


提示 : 要 创建 XML 解析 器 ， 请 使 用 xml parser create() Ak. 


例子 


<?php 


$xmlparser = xml parser create(), 


xml parser free($xmlparser), 


?> 


Ne 


PHP xml parser get option() 2 


= . M 
xml parser get option() 函数 从 XML 解析 器 获取 选项 设置 信息 。 
语法 


xml parser get option(parser,option) 


参数 描述 
parser ”必需 。 规 定 要 使 用 的 XML 解析 器 。 


必需 。 规 定 要 获取 的 设置 选项 名 称 。 可 能 的 值 : XML OPTION CASE FOLDING 


option XML. OPTION TARGET ENCODING 





说 明 


如 果 parser 参数 没有 指向 一 个 合法 的 解析 器 或 者 option 参数 无 效 ， 该 函数 将 返回 
FALSE (同时 产生 E_WARNING 警告 ) 。 否 则 将 返回 指定 设置 选项 的 值 。 


例子 


<?php 
$xmlparser = xml parser create(); 


echo xml parser get option($xmlparser, XML OPTION CASE FOLDING); 


xml parser free($xmlparser); 
?> 


PHP xml parser set option() 函数 


ris. : 
xml parser set option() EH#% XML 解析 器 进行 选项 设置 。 


如 果 成 功 ， 则 返回 true, MRAM, MRE false. 


语法 


xml parser set option(parser,option, value) 


参数 描述 
parser ”必需 。 规 定 要 使 用 的 XML 解析 器 。 
必需 。 规 定 要 设置 的 设置 选项 名 称 。 可 能 的 值 : XML OPTION CASE FOLDING 


option XML OPTION SKIP TAGSTART XML OPTION SKIP WHITE 
XML OPTION TARGET ENCODING 





value 必需 。 规 定 选项 的 新 值 。 


例子 


<?php 
$xmlparser = xml parser create(), 


xml parser set option($xmlparser, XML OPTION SKIP WHITE, 1), 


xml parser free($xmlparser); 
?> 


PHP xml set character data handler() Až 


定义 和 用 法 

xml set character data handler() 函数 建立 字符 数据 处 理 器 。 
函数 规定 当 解 析 器 在 XML 文件 中 找到 字符 数据 时 所 调用 的 函数 。 

如 果 义 理 器 被 成 功 的 建立 ， 该 函数 将 返回 true ; 否则 返回 false. 


语法 


xml set character data handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 作为 事件 处 理 器 使 用 的 函数 。 


由 handler 参数 规定 的 函数 必须 有 两 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
data 必需 。 规 定 包含 字符 数据 的 变量 。 


说 明 


handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting!</body> 
</note> 


PHP 代码 : 


<?php 
$parser-xml parser create(); 
function char($parser, $data) 


echo $data; 


} 


xml set character data handler(S$parser, char"); 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 
t 
xml parse($parser,$data,feof($fp)) or 
die (sprintf("XML Error: %s at line %d", 
xml error string(xml get error code($parser)), 
xml get current line number($parser))); 


} 


xml_parser_free($parser); 
?> 


输出 : 


George John Reminder Don"t forget the meeting! 


PHP xml set default handler() 函数 


定义 和 用 法 

xml set default handler() 函数 为 XML 解析 器 建立 默认 的 数据 处 理 器 。 
该 图 数 规定 在 只 要 解析 器 在 XML 文件 中 找到 数据 时 ， 所 调用 的 函数 。 
如 果 处 理 器 被 成 功 的 建立 ， 该 琅 数 业 返回 true ; 否则 返回 false. 


语法 


xml set default handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 作为 事件 处 理 器 使 用 的 函数 。 


由 handler 参数 规定 的 函数 必须 有 三 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
data 必需 。 规 定 包含 数据 的 变量 。 
说 明 


handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 
XML 文件 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 

<body>Don't forget the meeting!</body> 
</note> 


PHP 代码 : 


<?php 
$parser-xml parser create(); 
function default($parser, $data) 


echo $data; 


} 


xml set default handler($parser,"default"), 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 


xml parse($parser,$data,feof($fp)) or 

die (sprintf ("XML Error: %s at line %d", 

xml error string(xml get error code($parser)), 
xml get current line number ($parser))), 


} 


xml_parser_free($parser); 
?> 


输出 : 


George John Reminder Don"t forget the meeting! 


如 果 在 浏览 器 中 查看 源 代码 ， 会 看 到 下 列 HTML : 


<note> 

<to>George</to> 

<from>John</from> 
<heading>Reminder</heading> 
<body>Don't forget the meeting! </body> 
</note> 


PHP xml set element handler() HŽ% 


ris. : 
xml set element handler() 函数 建立 起 始 和 终止 元 素 处 理 器 。 


如 果 义 理 器 被 成 功 的 建立 ， 该 函数 将 返回 true ; 否则 返回 false. 
语法 


xml set element handler(parser,start,end) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
start 必需 。 规 定 在 元 素 开 始 调用 的 函数 。 
end 必需 。 规 定 在 元 素 结束 调用 的 函数 。 


由 start 参数 规定 的 函数 必须 有 三 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 人 处理 器 的 XML 解析 器 。 
name 必需 。 规 定 一 个 变量 ， 包 含 元 素 的 名 称 ， 这 个 元 素 触 发 该 图 数 。 
data 必需 。 规 定 一 个 数组 ， 包 含 元 素 属 性 。 


由 end 参数 规定 的 函数 必须 有 三 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
需 。 规 定 一 个 变量 ， 包 含 元 素 的 名 称 ， 这 个 元 素 触发 该 图 数 。 


name WO rm 


34 BH 


start 和 end 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 


<?php 
$parser-xml parser create(); 
function start($parser, $element name, $element attrs) 


switch($element name) 


case "NOTE": 

echo "-- Note --<br />"; 
break; 

case "TO": 

echo "To: "; 

break; 

case "FROM": 

echo "From: "; 

break; 


case "HEADING": 
echo "Heading: "; 
break; 
case "BODY": 
echo "Message: "; 
J 

J 


function stop($parser, $element name) 


t 


echo "«br /»"; 


} 


function char($parser, $data) 


echo $data; 


} 


xml set element handler($parser,"start","stop"): 
xml set character data handler(S$parser, char"); 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 


xml parse($parser,$data,feof($fp)) or 

die (sprintf("XML Error: %s at line %d", 

xml error string(xml get error code($parser)), 
xml get current line number($parser))); 


J 
xml parser free($parser), 


2» 


输出 : 


-- Note -- 

To: George 

From: John 

Heading: Reminder 

Message: Don"t forget the meeting! 


PHP xml set external entity ref handler() [4 
BN 
定义 和 用 法 


xml set external entity ref handler() EAŽITALIE 4 ARATASTE XML 文档 中 找到 外 部 实体 时 被 调 
FANN EX, 


MRAR EZ, ARRONE true ; 否则 返回 false. 
语法 


xml set external entity ref handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 当 解 析 器 找到 外 部 实体 时 被 调用 的 函数 。 


由 handler 参数 规定 的 男 数 必须 有 六 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
name 必需 。 规 定 包含 外 部 实体 名 称 的 变量 。 
paru 必需 。 S 包含 解析 外 部 实体 的 系统 标识 符 (system_id ) 的 基 
础 。 当 前 该 参数 通常 都 被 设置 为 空 字符 串 。 
system id 必需。 规定 包含 外 部 实体 的 系统 标识 符 的 变量 。 
public id 必需 。 规 定 包含 外 部 实体 的 公共 标识 符 的 变量 。 
说 明 


handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 


<?php 
$parser-xml parser create(); 
function char($parser, $data) 


echo $data; 


} 


function ext ent handler($parser, $ent, $base, $sysID, $pubID) 


echo "$ent"; 
echo "$sysID"; 
echo "$pubID"; 
x 


xml set character data handler(S$parser," char"); 
xml set external entity ref handler($parser, "ext ent handler"); 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 
xml parse($parser,$data,feof($fp)) or 
die (sprintf("XML Error: %s at line %d", 


xml error string(xml get error code($parser)), 
xml get current line number($parser))); 


} 
xml parser free($parser), 


?> 


PHP xml set notation decl handler() 2 


ro 、 : 
定义 和 用 法 

xml set notation decl handler() 函数 规定 当 解 析 器 在 XML 文档 中 找到 符号 声明 时 被 调用 的 
KESA 

ASR BSS RAMA, KRAE] true ; 否则 返回 false, 

注释 :“ 符 号 声明 ”英文 为 notation declaration， 也 有 部 分 文献 译 为 “注释 声明 ”。 


语法 


xml set notation decl handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 当 解析 器 找到 符号 声明 时 被 调用 的 函数 。 


由 handler 参数 规定 的 函数 必须 有 六 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
name 必需 。 规 定 包含 实体 名 称 的 变量 。 
ca 必需 。 规定 一 个 变量 ， O A (system id) 的 基础 。 
当前 该 参数 通常 都 被 设置 为 空 字符 串 。 
system id 必需。 规定 包含 实体 的 系统 标识 符 的 变量 。 
public id 必需 。 规 定 包含 实体 的 公共 标识 符 的 变量 。 
notation 必需 。 规 定 一 个 变量 ， 包 含 标识 实体 数据 类 型 的 符号 。 
说 明 


handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 


<?php 
$parser-xml parser create(); 
function char($parser, $data) 


echo $data; 


d 
function not decl handler($parser, $not, $base, $sysID, $pubID) 


echo "$not«br /»"; 
echo "$sysID<br />", 
echo "$pubID<BR />", 
} 


xml_set_character_data_handler($parser,"char"); 
xml_set_notation_decl_handler($parser, "not_decl_handler"); 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 
xml parse($parser,$data,feof($fp)) or 
die (sprintf( "XML Error: %s at line %d", 


xml error string(xml get error code($parser)), 
xml get current line number ($parser))), 


} 
xml parser free($parser), 


?> 


PHP xml set object() HŽ% 
定义 和 用 法 

xml set object() HŽ EI RREA XML 解析 器 。 
语法 


xml set object(parser,object) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
object 必需 。 规 定 设 置 解析 器 的 对 象 。 


说 明 


该 图 数 使 得 parser 指定 的 解析 器 可 以 被 用 在 object 对 象 中 。 所 有 的 回 叫 函数 (callback 
function) 都 可 以 由 xmlset element handler() SHRMRikie, "Ct XE object 对 象 的 
方法 。 


例子 


<?php 
class XMLParser 


var $xmlparser, 
function XMLParser() 


$this->xmlparser - xml parser create(); 

xml set object($this->xmlparser, $this); 

xml set character data handler($this-»xmlparser,"char"); 

xml set element handler($this->xmlparser, "start tag","end tag"); 


} 


function parse($data) 


xml_parse($this->xmlparser, $data); 


} 


function parse File($xmlfile) 
{ 
$fp = fopen($xmlfile, 'r'); 
while ($xmldata = fread($fp, 4096) ) 


{ 

if 

(!xml_parse($this->xmlparser, $xmldata)) 
{ 
//If error 


us print "ERROR: " 
xml error string(xml get error code($this-»xmlparser)) 
. "<br /»Line: " 
. xml get current line number($this->xmlparser) 
. "«br /»Column: " 
. xml get current column number($this-»xmlparser) 
a Heol 1)77 
J 


} 
} 


function start tag($xmlparser, $tag, $attributes) 


print $tag . "<br />"; 
} 


function end tag() + 


function char ($xmlparser, $data) 


echo $data . "<br /»"; 
J 
function close Parser() 
t 
xml parser free($this->xmlparser), 
J 


J 

$myxmlparser - new XMLParser(); 
$myxmlparser ->parse File("test.xml"), 
$myxmlparser ->close parser(); 


2» 


PHP xml set processing instruction handler() 


Ex ZA 
定义 和 用 法 


xml set processing instruction handler() EM 2X40 7 4 RAT ZETE XML 文档 中 找到 义理 指令 时 
所 调用 的 函数 。 

义理 指令 包含 在 <? 和 ?> 分 隔 符 中 。 

如 果 处 理 器 被 成 功 的 建立 ， 该 图 数 将 返回 true ; 否则 返回 false, 

例子 : 在 本 例 中 ， 处 理 指 合 把 一 个 样式 表 和 与 XML 文档 关联 起 来 : 


<?xml version-"1.0" encoding-"ISO-8859-1"?> 
<?xml-stylesheet href-"default.xsl" type-"text/xml"?> 
<note> 

<to>Tove</to> 

<from>Jani</from> 

<heading>Reminder</heading> 

<body>Don't forget me this weekend!</body> 

</note> 


语法 


xml set processing instruction handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 一 个 函数 。 


© 


FA handler 参数 规定 的 函数 必须 有 三 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
target 必需 。 规 定 包含 多 理 指 命 目标 的 变量 。 
data 必需 。 规 定 包含 处 理 指令 数据 的 变量 。 


说 明 
handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 


<?php 
$parser-xml parser create(); 
function char($parser, $data) 


echo $data; 


} 


function pi handler($parser, $target, $data) 


t 
echo "Target: $target<br />"; 
echo "Data: $data<br />"; 


} 


xml_set_character_data_handler($parser,"char"); 
xml_set_processing_instruction_handler($parser, "pi_handler"); 
$fp-fopen("test.xml","r"); 


while ($data-fread($fp, 4096)) 
xml_parse($parser, $data, feof ($fp)) or 
die (sprintf("XML Error: %s at line %d", 


xml_error_string(xml_get_error_code($parser)), 
xml get current line number($parser))); 


J 
xml parser free($parser), 


2» 


PHP xml set unparsed entity decl handler() 
函数 


定义 和 用 法 


xml set unparsed entity decl handler() 函数 规定 在 遇 到 无 法 解析 的 实体 名 称 (NDATA) 声 


BA at 1868 FH BIER AUC, 
MRAR EZ, iR AACS IRE true ; 否则 返回 false. 


语法 


xml set unparsed entity decl handler(parser,handler) 


参数 描述 
parser 必需 。 规 定 要 使 用 的 XML 解析 器 。 
handler 必需 。 规 定 一 个 加 数 。 


由 handler 参数 规定 的 函数 必须 有 六 个 参数 : 


参数 描述 
parser 必需 。 规 定 一 个 变量 ， 包 含 调用 处 理 器 的 XML 解析 器 。 
name 必需 。 规 定 包含 实体 名 称 的 变量 。 
Ba 必需 。 规 定 一 个 变量 ， 包 含 解析 实体 的 系统 标识 符 (system id) 的 基础 。 
当前 该 参数 通常 都 被 设置 为 空 字 符 串 。 


常 
包含 实体 的 系统 标识 符 的 变量 。 
2 


system id ŽÚR. ME 

public id 必需 。 规 定 包含 实体 的 公共 标识 符 的 变量 。 

notation 必需 。 规 定 一 个 变量 ， 包 含 标 识 实 体 数 据 类 型 的 符号 。 
说 明 


handler 参数 也 可 以 是 一 个 数组 ， 其 中 包含 对 象 引 用 和 方法 名 。 


例子 


<?php 
$parser-xml parser create(); 
function char($parser, $data) 


echo $data; 


} 


function unparsed ent handler($parser, $entname, 
$base, $sysID, $pubID, $notname ) 


print "$entname"; 
print "$sysID"; 
print "$pubID"; 
print "$notname"; 


d 


xml set character data handler(S$parser, char"); 
xml set unparsed entity decl handler($parser, 
"unparsed ent handler"); 


$fp-fopen("test.xml","r"); 

while ($data-fread($fp, 4096)) 
{ 
xml_parse($parser, $data, feof ($fp)) or 
die (sprintf("XML Error: %s at line %d", 


xml_error_string(xml_get_error_code($parser)), 
xml get current line number($parser))); 


} 
xml parser free($parser), 


2» 


PHP Zip File 函数 


PHP Zip File 简介 


H8 SAE 25 JO P4113: BUS H8 SC 


m 


AE 
女 


如 需 在 服务 器 上 运行 Zip File 函数 ， 必 须 安装 这 些 库 : 

e Guido Draheim 的 ZZIPlib 库 : 下 载 ZZIPlib = 

e Zip PELC 扩展 : 下 载 Zip PELC 扩展 

在 Linux 系统 上 安装 

PHP 5+: Zip HRA Zip 库 默 认 不 会 和 启用， 必须 从 上 面 的 链接 下 载 。 请 使 用 --with-zip=DIR_ 
配置 选项 来 包含 Zip 支持 。 

在 Windows 系统 上 安装 


_PHP 5+: Zip 本 数 默认 不 会 和 启用， 必须 从 上 面 的 链接 下 载 php_zip.dll 和 ZZIPlib 库 。 必 须 
在 php.ini 之 内 启用 php_zip.dll. 


如 需 和 启用 任何 PHP 扩展 ，PHP extension dir 设置 (在 php.ini 文件 中 ) 应 该 设置 为 该 PHP 
扩展 所 在 的 目录 。 举 例 extension dir 的 值 可 能 是 c:\php\ext。 


PHP Zip File 函数 


PHP : ERER i PA RBS PHP 版 本 。 


zip close() 
zip entry close() 
zip entry compressedsize() 


zip entry compressionmethod() 
zip entry filesize() 


zip entry name() 
zip entry open() 
zip entry read() 
zip open() 

zip read() 


PHP Zip File 常量 


无 。 


2| 
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HP Zip File EZ 


描述 
关闭 ZIP 文件 。 
关闭 ZIP 文件 中 的 一 个 项 目 。 
返回 ZIP 文件 中 的 一 个 项 目的 被 压缩 尺寸 。 
返回 ZIP 文件 中 的 一 个 项 目的 压缩 方法 。 


返回 ZIP 文件 中 的 一 个 项 目的 实际 文件 尺 
We 


返回 ZIP 文件 中 的 一 个 项 目的 名 称 。 
打开 ZIP 文件 中 的 一 个 项 目 以 供 读 取 。 
读 取 ZIP 文件 中 的 一 个 打开 的 项 目 。 
打开 ZIP 文件 。 

读 取 ZIP 文件 中 的 下 一 个 项 目 。 


PHP 


A AA A Aa FA 


A A A A RA 


PHP zip close() Ha 
定义 和 用 法 
zip close() HŽ 4 A zip open() KAHF ÉS zip 档案 文件 。 
语法 
zip close(zip) 


参数 描述 
zip 必需 。 规 定 要 关闭 的 zip 资源 (由 zip open() 打开 的 zip 文件 ) 。 


例子 


<?php 
$zip = zip open("test.zip"); 


zip read($zip), 
V Ea Ja no 


zip close($zip), 
?> 


PHP zip entry close() 函数 


定义 和 用 法 
zip entry close() RANA i] Fi zip entry open() 函数 打开 的 zip 档案 文件 。 
语法 


zip entry close(zip entry) 


参数 描述 
zip_entry 必需 。 规 定 要 关闭 的 zip 项 目 资源 (由 zip read() 打开 的 zip MAB) o 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 
{ 


echo "<p>": 
echo "Name: " . zip entry name($zip entry) . "<br />"; 


if (zip entry open($zip, $zip entry)) 


// TEN... 
zip entry close($zip entry), 


echo "«/p»"; 
zip close($zip), 


J 


2» 


PHP zip entry compressedsize() EX2X 


= ~ N 
zip entry compressedsize() H2GRE] zip 档案 项 目的 压缩 文件 尺寸 。 
语法 


zip entry compressedsize(zip entry) 


参数 描述 
zip_entry 必需 。 规 定 要 读 取 的 zip 项 目 资源 (由 zip read() 打开 的 zip MA) o 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 
{ 


echo "<p>"; 

echo "Name: " . zip_entry_name($zip_entry) . "<br />"; 
echo "Compressed Size: " 

. Zip entry compressedsize($zip entry), 

echo "«/p»"; 


zip close($zip), 


} 


?> 


输出 : 
Name: ziptest.txt 
Compressed Size: 68 


Name: htmlziptest.html 
Compressed Size: 159 


PHP zip entry compressionmethod() 函数 


= ~ M 
zip entry compressionmethod() 函数 返回 zip 档案 项 目的 压缩 方法 。 
语法 


zip entry compressionmethod(zip entry) 


参数 描述 
zip_entry 必需 。 规 定 要 读 取 的 zip 项 目 资源 (由 zip read() 打开 的 zip MA) o 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 
{ 


echo "<p>"; 

echo "Name: " . zip_entry_name($zip_entry) . "<br />"; 
echo "Compression Method: " 

. Zip entry compressionmethod($zip entry), 

echo "«/p»"; 


zip close($zip), 


} 


?> 


输出 : 
Name: ziptest.txt 
Compression Method: deflated 


Name: htmlziptest.html 
Compression Method: deflated 


iva 


PHP zip entry filesize() 西数 


= ~ M 
zip entry filesize() Exo zip 档案 项 目的 原始 大 小 〈 在 压缩 之 前 ) o 
语法 


zip entry filesize(zip entry) 


参数 描述 
zip_entry 必需 。 规 定 要 读 取 的 zip 项 目 资源 (由 zip read() 打开 的 zip MA) o 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 

while ($zip entry - zip read($zip)) 
{ 
echo "«p»"; 
echo "Name: " . zip entry name($zip entry) . "<br /»"; 
echo "Original size: " . zip entry filesize($zip entry); 
echo "«/p»"; 

zip close($zip), 


?> 


输出 : 
Name: ziptest.txt 
Original size: 68 


Name: htmlziptest.html 
Original size: 159 


PHP zip entry name() 2% 


ma 、 : 
zip_entry_name() KHUNE zip 档案 项 目的 名 称 。 
语法 


zip entry name(zip entry) 


参数 描述 
zip_entry 必需 。 规 定 要 读 取 的 zip 项 目 资源 (由 zip read() 打开 的 zip MA) o 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 
A "Name: " . zip entry name($zip entry) . "<br />"; 
zip_close($zip); 


} 


?> 


输出 类 似 : 


Name: ziptest.txt 
Name: htmlziptest.html 


PHP zip entry open() 2X 
定义 和 用 法 

zip entry open() HAF FAT ZIP 档案 项 目 以 供 读 取 。 
语法 


zip entry open(zip,zip entry,mode) 


参数 描述 
zip 必需 。 规 定 要 读 取 的 zip 资源 (由 zip open() 打开 的 zip 文件 ) 。 


定 
zip_entry ”必需 。 规 定 要 打开 的 zip 项 目 资源 (由 zip read() 打开 的 zip MA) 。 
mode 可 选 。 规 定 zip 档案 项 目的 访问 类 型 。 


说 明 


ft PHP 5 M, mode 会 被 忽略 ， 且 总 为 "rb"。 这 是 因为 在 PHP 中 的 zip 支持 是 只 读 的 。 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 


echo "<p>": 
echo "Name: " . zip entry name($zip entry) . "<br />"; 


if (zip entry open($zip, $zip entry)) 
x 
// some code 


echo "«/p»"; 


} 


zip_close($zip); 


} 


2» 


PHP zip entry read() 函数 


ch 、 : 
zip entry read() 函数 从 打开 的 zip 档案 项 目 中 获取 内 容 。 
如 果 成 功 ， 则 返回 项 目的 内 容 。 如 果 失 败 ， 则 返回 false. 


语法 


zip_entry_read(zip_entry, length) 


参数 描述 
zip entry ”必需 。 规 定 要 读 取 的 zip 项 目 资源 (由 zip read() 打开 的 zip 项 目 ) 。 
length 可 选 。 规 定 返回 的 字 节 数 。 默 认 是 1024. 


例子 


<?php 
$zip = zip open("test.zip"); 


if ($zip) 
while ($zip entry - zip read($zip)) 


echo "«p»"; 
echo "Name: " . zip entry name($zip entry) . "<br /»"; 
if (zip entry open($zip, $zip entry)) 

t 

echo "File Contents:«br/»"; 

$contents - zip entry read($zip entry); 

echo "$contents«br /»"; 

zip entry close($zip entry); 


echo "«/p»"; 


J 


zip close($zip), 


J 


?> 


PHP zip open() HX 


= 、 : 
zip open() ERZX3TZT ZIP 文件 以 供 读 取 。 
如 果 成 功 ， 则 返回 zip 文件 档案 资源 。 如 果 失 败 ， 则 返回 false, 


zip open(filename) 


参数 描述 
filename 必需 。 规 定 要 打开 的 zip 文件 的 文件 名 和 路 径 。 


提示 和 注释 


提示 : 新 打开 的 zip 文件 资源 之 后 可 被 zip_read() 和 zip close() BAER. 


例子 


<?php 
$zip = zip open("test.zip"); 


zip read($zip); 
// —E( 3... 


zip close($zip), 
?> 


PHP zip read() 函数 


定义 和 用 法 
zip read() HUHI F BY zip 档案 中 的 下 一 个 文件 。 


如 果 成 功 ， 则 返回 包含 zip 档案 中 一 个 文件 的 资源 。 如 果 没 有 更 多 的 项 目 可 供 读 取 ， 则 返回 
false。 


语法 


zip read(zip) 


参数 描述 
zip 必需 。 规 定 要 读 取 的 zip 资源 (由 zip open() 打开 的 zip 文件 ) 。 


提示 和 注释 


提示 : 由 zip read() 函数 返回 的 资源 可 供 zip entry... 类 的 函数 使 用 。 


例子 


<?php 
$zip = zip open("test.zip"); 


zip read($zip): 
// 一 些 代 码 ... 


zip close($zip); 
?» 


PHP žm 


PHP % AERA fa) JT 


RETE FEE NBR ASTRA. 


far m d 
安装 


杂项 图 数 是 PHP 核心 的 组 成 部 分 。 无 


ignore user abort "0" 


highlight.string "#DDO0000" 
highlight. comment "#FF8000" 
highlight.keyword "#007700" 
highlight.bg "RFFFFFF" 
highlight.default "#0000BB" 
highlight.html "#000000" 
browscap NULL 


PHP 杂项 回 数 


受到 php.ini 中 设置 


默认 


需 安装 即 可 使 用 这 些 函 数 。 


的 影 响 。 


描述 


FALSE 指示 只 要 脚本 在 客户 
HE et A 进行 输 
出 ， 脚 本 将 被 终止 。 


供 突出 显示 符合 PHP 语法 
的 字符 串 而 使 用 的 颜色 。 


供 突出 显示 PHP 注释 而 使 
用 的 颜色 。 


供 突 出 显示 PHP 关键 词 而 
使 用 的 颜色 〈 比 如 圆 括号 和 
oni 


背景 颜色 。 

PHP 语法 的 默认 颜色 。 
HTML 代码 的 颜色 。 

浏览 器 性 能 文件 的 名 称 和 位 


a (例如 : 
browscap.ini) 。 


PHP : 指示 支持 该 函数 的 最 早 的 PHP 版 本 。 


可 更 改 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 


PHP INI ALL 
PHP INI ALL 
PHP INI ALL 


PHP INI SYSTEM 


Až 
connection aborted() 
connection status() 
connection timeout() 
constant() 
define() 
defined() 
die() 
eval() 
exit() 
get browser() 
highlight file() 
highlight string() 
ignore user abort() 
pack() 
php check syntax() 
php strip whitespace() 
show source() 
sleep() 
time nanosleep() 
time sleep until() 
uniqid() 
unpack() 


usleep() 


PHP Date / Time 


PHP : 指示 支持 该 


描述 
检查 是 否 断 开 客户 机 。 
返回 当前 的 连接 状态 。 
在 PHP 4.0. 成 使 用 。 
返回 一 个 常量 的 值 。 
定义 一 个 常量 。 
检查 某 常量 是 否 存 在 。 


输出 一 条 消息 ， 并 退出 当前 脚本 。 
把 字符 串 按照 PHP 代码 来 计算 。 
输出 一 条 消息 ， 并 退出 当前 脚本 。 
返回 用 户 浏览 器 的 性 能 。 
对 文件 进行 语法 高 亮 显示 。 
对 字符 串 进行 语法 高 完 显 示 

设置 与 客户 机 断 开 是 否 会 终止 脚本 的 执行 。 
把 数据 装 入 一 个 二 进 制 字 符 串 。 
在 PHP 5.0.5 中 不 赞成 使 用 。 


返回 已 删除 PHP 注释 以 及 空白 字符 的 源 代码 文件 。 


highlight file() 的 别名 。 
延迟 代码 执行 若干 秒 。 

延迟 代码 执行 若干 秒 和 纳 秒 。 
延迟 代码 执行 指定 的 时 间 。 
生成 唯一 的 ID。 

二 进 制 字 符 串 对 数据 进行 解 包 。 
延迟 代码 执行 若干 微 秒 。 


nia E 


e me 


常量 的 最 早 的 PHP 版 本 。 


PHP 


U UU CQ Ci OC) U“ A U U CQ U A A CQ Q OQ U wo OQ A U mm 


Ho 


常 
CONNECTION_ABORTED 
CONNECTION_NORMAL 
CONNECTION TIMEOUT 
COMPILER HALT OFFSET 


PHP 


PHP connection aborted() 函数 


ch. S 
connection aborted() Hue & EGRE P Hlo 


如 果 已 终止 连接 ， 则 该 图 返回 1， 否 则 返回 0。 


语法 


connection_aborted() 


例子 
创建 一 个 函数 ， 在 客户 机 终止 脚本 时 写 入 一 条 日 志 消息 : 


<?php 
function check_abort() 
{ 
if (connection aborted()) 
error log ("Script $GLOBALS[SCRIPT NAME]" . 
"$GLOBALS[SERVER NAME] was aborted by the user."); 


J 
// 要 执行 的 一 些 代码 
// 在 脚本 结束 时 调用 check abort BA 


register shutdown function( "check abort"); 
?> 


PHP connection status() 2% 


= 、 S 
connection status() 函数 返回 当前 的 连接 状态 。 
可 返回 的 可 能 


e 0- CONNECTION NORMAL - 连接 运行 正常 

e 1- CONNECTION ABORTED - 连接 由 用 户 或 网 络 错误 终止 
e 2 - CONNECTION TIMEOUT - 连接 超时 

e 3- CONNECTION ABORTED 8 CONNECTION TIMEOUT 


语法 


connection status() 


例子 


<?php 
switch (connection status()) 


t 
case CONNECTION NORMAL: 


$txt - 'Connection is in a normal state'; 
break; 
case CONNECTION ABORTED: 
$txt - 'Connection aborted'; 
break; 
case CONNECTION TIMEOUT: 
$txt - 'Connection timed out'; 
break; 
case (CONNECTION ABORTED & CONNECTION TIMEOUT): 
$txt - 'Connection aborted and timed out'; 
break; 
default: 
$txt - 'Unknown'; 
break; 
} 
echo $txt; 


?> 


PHP constant() HŽ% 
定义 和 用 法 
constant() KHOR [p] EN f, 
语法 
constant(constant) 


BR 描述 


constant 必需 。 规 定 要 检查 的 常量 的 名 称 。 


提示 和 注释 


注释 : 该 吏 数 仅 适用 于 class BE. 


例子 


<?php 
// 定 义 一 个 常量 
define("GREETING", "Hello world!"), 


echo constant( "GREETING"), 
?> 


输出 : 


Hello world! 


PHP define() 函数 


co 、 S 
定义 和 用 法 

define() 函数 定义 一 个 常量 。 
常量 类 似 变量 ， 不 同 之 处 在 于 


。 在 设 定 以 后 ， 常 量 的 值 无 法 更 改 
。 常量 名 不 需要 开头 的 美元 符号 ($) 
。 作用 域 不 影响 对 常量 的 访问 

。 常量 值 只 能 是 字符 串 或 数字 


语法 


define( name , value , case insensitive ) 





参数 描述 
name V 
value v 


Em A HA AS g TES EX +n y n : 
case insensitive in idus e E 苟 设置 为 true, 则 对 大 小 


例子 
例子 1 


定义 一 个 大 小 写 敏感 的 常量 : 


<?php 

define("GREETING", "Hello world!"), 
echo constant( "GREETING"), 

?> 


输出 : 


Hello world! 


例子 2 
定义 一 个 大 小 写 不 敏感 的 常量 : 


<?php 
define("GREETING", "Hello world!", TRUE), 


echo constant("greeting"): 
?> 


输出 : 


Hello world! 


PHP defined() HŽ% 


定义 和 用 法 
defined() BRAK SRR BSEAFE, 


若 常 量 存在 ， 则 返回 true, FIRE false. 


语法 
defined(name ) 
参数 
name 必需 。 规 定 要 检查 的 常量 的 名 称 。 


例子 


<?php 

define("GREETING","Hello world!"); 
echo defined("GREETING"); 

?> 


输出 : 


PHP die() 函数 


定义 和 用 法 
die() 西数 输出 一 条 消息 ， 并 退出 当前 脚本 。 


该 图 数 是 exit() HAN 41 A. 


语法 
die(status) 
参数 描述 


status 必需。 规定 在 退出 脚本 之 前 写 人 的 消息 或 状态 号 。 状 态 号 不 会 被 写 人 输出 。 


说 明 
如 果 status 是 字符 串 ， 则 该 范 数 会 在 退出 前 输出 字符 串 。 


如 果 status 是 整数 ， 这 个 值 会 被 用 作 退 出 状态 。 退 出 状态 的 值 在 0 至 254 之 间 。 退 出 状态 
255 由 PHP 保留 ， 不 会 被 使 用 。 状 态 0 用 于 成 功 地 终止 程序 。 


提示 和 注释 


注释 : 如 果 PHP 的 版 本 号 大 于 等 于 4.2.0， 那 么 在 status 是 整数 的 情况 下 ， 不 会 输出 该 参 
数 。 


例子 


<?php 

$site = "http://www.w3school.com.cn/"; 
fopen($site,"r") 

or die("Unable to connect to $site"); 
?> 


PHP eval() EX 


mo. N 
eval() KAE FRERE PHP 代码 来 计算 。 
该 字符 串 必 须 是 合法 的 PHP 代码 ， 且 必须 以 分 号 结尾 。 


如 果 没 有 在 代码 字符 串 中 调用 return 语句 ， 则 返回 NULL。 如 果 代 码 中 存在 解析 错误 ， 则 
eval() 函数 返回 false. 


语法 
eval(phpcode) 
参数 描述 
phpcode 必需 。 规 定 要 计算 的 PHP 代码 。 


提示 和 注释 
注释 : 返回 语句 会 立即 终止 对 字符 串 的 计算 。 
主 释 : 该 吏 数 对 于 在 数据 库 文本 字段 中 供 日 后 计算 而 进行 的 代码 存储 很 有 用 。 


~ 


<?php 

$string = "beautiful"; 

$time = "winter"; 

$str = "This is a $string $time morning!'; 


echo $str. "<br /»"; 
eval("N$str = N'$strN";"); 


echo $str; 
?» 


输出 : 


This is a $string $time morning! 
This is a beautiful winter morning! 


PHP exit() E32 


rm . ` 
exit() FARA H— RE, HRH EA BUTS S 
该 图 数 是 die() HAN 31 A. 
语法 
exit(status) 
参数 描述 
status ”必需 。 规 定 在 退出 脚本 之 前 写 入 的 消息 或 状态 号 。 状 态 号 不 会 被 宇 入 输出 。 
说 明 
如 果 status 是 字符 串 ， 则 该 画 数 会 在 退出 前 输出 字符 串 。 


如 果 status 是 整数 ， 这 个 值 会 被 用 作 退 出 状态 。 退 出 状态 的 值 在 0 E 254 之 间 。 退 出 状态 
255 由 PHP 保留 ， 不 会 被 使 用 。 状 态 0 用 于 成 功 地 终止 程序 。 


提示 和 注释 


注释 : 如 果 PHP 的 版 本 号 大 于 等 于 4.2.0， 那 么 在 status 是 整数 的 情况 下 ， 不 会 输出 该 参 
数 。 


例子 


<?php 

$site = "http://www.w3school.com.cn/"; 
fopen($site,"r") 

or exit("Unable to connect to $site"); 
?> 


PHP get browser() HŽ% 


定义 和 用 法 
get browser() 函数 返回 用 户 浏 览 器 的 性 能 。 


郴 数 通 过 查阅 用 户 的 browscap.ini 文件 ， 来 测定 用 户 浏览 器 的 性 能 。 
若 成 功 ， 则 该 范 数 返回 包含 用 户 浏 览 器 信息 的 一 个 对 象 或 一 个 数组 ， 若 失败 ， 则 返回 false, 


语法 


get browser(user agent,return array) 


参数 描述 

POET 可 选 。 规 定 HTTP 用 户 代理 的 名 称 。 默认 是 $HTTP USER AGENT 的 
eus 值 。 您 可 以 通过 设置 NULL 绕 过 该 参数 。 

return array ”可 选 。 如 果 该 参数 设置 为 trtue， 本 图 数 会 返回 一 个 数组 而 不 是 对 象 。 


提示 和 注释 
注释 : 返回 语句 会 立即 终止 对 字符 串 的 计算 。 
注释 : 该 贺 数 对 于 在 数据 库 文 本 字段 中 供 日 后 计算 而 进行 的 代码 存储 很 有 用 。 


例子 


<?php 

echo $ SERVER[ "HTTP USER AGENT"] . "<br /><br />", 
$browser = get browser(null, true); 

print r($browser), 

?> 


输出 : 


Mozilla/4.0 
(compatible; MSIE 6.0, Windows NT 5.1; SV1, .NET CLR 1.1.4322) 


Array 

( 

[browser name regex] => Amozilla/.\.0 
(compatible; msie 6\.0.*;.*windows nt 5\.1.*\.net clr.*).*$ 
[browser name pattern] -» Mozilla/?.0 
(compatible; MSIE 6.0*;*Windows NT 5.1*.NET CLR*)* 
[parent] -» IE 6.0 

[platform] -» WinXP 

[netclr] -> 1 

[browser] -» IE 

[version] -» 6.0 

[majorver] => 6 

[minorver] -» 0 

[css] => 2 

[frames] -> 1 

[iframes] => 1 

[tables] -> 1 

[cookies] => 1 

[backgroundsounds] => 1 

[vbscript] => 1 

[javascript] => 1 

[javaapplets] => 1 

[activexcontrols] => 1 

[cdf] => 1 

[aol] => 

[beta] => 

[win16] => 

[crawler] => 

[stripper] => 

[wap] => 

[ak] => 

[sk] => 

) 


PHP highlight file() 3% 
定义 和 用 法 

highlight file() 本 数 对 文件 进行 语法 高 之 显示 。 
语法 


highlight file(filename, return) 


参数 描述 
filename We, BETSEY PHP 文件 的 路 径 。 
return 可 选 。 如 果 设 置 true， 则 本 画 数 返回 高 亮 处 理 的 代码 。 
说 明 


本 画 数 通过 使 用 PHP 语法 高 亮 程序 中 定义 的 颜色 ， 输 出 或 返回 包含 在 flename 中 的 代码 的 语 
MESS. 


许多 服务 器 被 配置 为 对 带 有 phos 后 级 的 文件 进行 自动 高 亮 处 理 。 例 如 ， 在 查看 
example.phps 时 ， 将 显示 该 文件 被 语法 高 这 显示 的 源 代码 。 要 启用 该 功能 ， 请 把 下 面 这 一 行 
添加 到 httod.conf : 


AddType application/x-httpd-php-source .phps 


3 [n] fi 


如 果 return 参数 被 设置 为 true, PAAHMARORKSRKRENKS, MARSH. B 
则 ， 若 成 功 ， 则 返回 true， 失 败 则 返回 false. 


提示 和 注释 


告 : 需要 注意 的 是 ， 在 使 用 highlight file() 函数 时 ， 请 不 要 因为 玖 忽而 港 露 诸如 密码 或 其 他 
类 型 的 敏感 信息 ， 否 则 会 出 现 潜 在 的 安全 风险 。 


x A 


例子 


"test.php": 


«html» 

«body» 

«?php 

highlight file("test.php"); 
?> 

</body> 

</html> 


输出 : 


<html> 

<body> 

<?php 

highlight file("test.php"); 
?> 


</body> 
</html> 


在 浏览 器 中 查看 的 结果 类 似 这 样 : 


<html> 

<body> 

<code> 

<span style="color: #000000">&lt;html&gt; 

<br /> 

&lt;body&gt; 

«br /» 

<span style="color: #0000BB">&1t;?php 

<br />highlight_file</span> 

<span style="color: #007700">(</span> 

<span style="color: #DDO000">"test.php"</span> 
<span style="color: #007700">);<br /></span> 
<span style="color: #0000BB">?&gt;<br /></span> 
&1t;/body&gt ; 

<br /> 

&1t;/html&gt ; </span> 

</code> 

</body> 

</html> 


PHP highlight string() 函数 
定义 和 用 法 
highlight string() 范 数 对 字符 捉 进行 语法 高 亮 显 示 。 


语法 


highlight_string(string,return) 


参数 描述 
string 必需 。 要 进行 高 亮 处 理 的 字符 串 。 
return 可 选 。 如 果 设 置 true, WMANZROSRKRENKA. 


本 函数 通过 使 用 PHP 语法 高 亮 程序 中 定义 的 颜色 ， 输 出 或 返回 给 定 的 PHP 代码 的 语法 高 亮 
版 本 。 
3 [e| f 


如 果 return 参数 被 设置 为 true， 和 那么 该 函数 会 以 字符 串 返 回 被 高 亮 处 理 的 代码 ， 而 不 是 输出 
它们 。 否 则 ， 若 成 功 ， 则 返回 true， 失 败 则 返回 false. 


例子 


<html> 

<body> 

<?php 

highlight string("Hello world! <?php phpinfo(), ?>"); 
?> 


</body> 
</html> 


输出 : 


Hello world! <?php phpinfo();?» 


TE a de PE SAR KH 


<html> 

<body> 
<code> 
<span 
<span 
<span 
<span 


style-"color: 
style-"color: 
style-"color: 
style-"color: 


</span> 


</code> 
</body> 
</html> 


#000000">Hello&nbsp; world! &nbsp; 
#0000BB">&1t ; ?7php&nbsp; phpinfo</span> 
#007700">();</Span> 
#0000BB">?&gt ; </span> 


PHP ignore user abort() 函数 


= : 
ignore user abort() HRkBSE PMA Sos LMA. 


本 函数 返回 user-abort 设置 的 之 前 的 值 (一 个 布尔 值 ) 。 
语法 
ignore user abort(setting) 


参数 描述 


setiing 可 选 。 如 果 设 置 为 true， 则 忽略 与 用 户 的 断 开 ， 如 果 设 置 为 false， 会 导致 脚本 
停止 运行 。 如 果 未 设置 该 参数 ， 会 返回 当前 的 设置 。 


提示 和 注释 


注释 : PH 不 会 检测 到 用 户 是 否 已 断 开 连 接 ， 直 到 尝试 向 客户 机 发 送信 息 为 止 。 简 单 地 使 用 
echo 语句 无 法 确保 信息 发 送 ， 参 阅 flush() BR, 


例子 


<?php 
ignore user abort(); 
?> 


输出 : 


PHP pack() KŻ 
定义 和 用 法 

pack) 画 数 把 数据 装 入 一 个 二 进 制 字 符 串 。 
语法 


pack(format,args+) 


参数 描述 
format 必需 。 规 定 在 包装 数据 时 所 使 用 的 格式 。 
args* 可 选 。 规 定 被 包装 的 一 个 或 多 个 参数 。 


format 参数 的 可 能 


e a- NUL-paddeg string 

e A- SPACE-paddeg string 

e h - Hex string, low nibble first 

e H - Hex string, high nibble first 

e c- signed char 

e C-unsigned char 

e s - signed short (always 16 bit, machine byte order) 

e S-unsigned short (always 16 bit, machine byte order) 

e n-unsigned short (always 16 bit, big endian byte order) 
e v-unsigned short (always 16 bit, little endian byte order) 
e i- signed integer (machine dependent size and byte order) 
e |- unsigned integer (machine dependent size and byte order) 
e |- signed long (always 32 bit, machine byte order) 

e L-unsigned long (always 32 bit, machine byte order) 

e N-unsigned long (always 32 bit, big endian byte order) 
e V - unsigned long (always 32 bit, little endian byte order) 
e f- float (machine dependent size and representation) 

e d - double (machine dependent size and representation) 
e x- NUL byte 

e X- Back up one byte 

e @ - NUL-fill to absolute position 


例子 
例子 1 


<?php 
echo pack("C3",80, 72,80); 
?» 


输出 : 


PHP 


例子 2 


<?php 
echo pack("C*", 80, 72, 80); 
?» 


输出 : 


PHP 


PHP strip whitespace() 2X 


= ~ N 
strip whitespace() 函数 返回 已 删除 PHP 注释 以 及 空白 字符 的 源 代码 文件 。 
该 画 数 对 于 检测 脚本 中 的 实际 代码 量 很 有 用 。 


语法 


strip whitespace(filename) 


参数 描述 
filename 必需 。 规 定 文件 名 。 


说 明 
若 成 功 ， 则 返回 被 剥离 的 源 代 码 ， 若 失败 ， 则 返回 空 字 符 串 。 


注释 : TE PHP 5.0.1， 该 函数 的 行为 与 上 面 的 描述 一 致 。 在 这 之 前 ， 它 和信 返回 空 字 符 串 。 


例子 


"test.php": 
<?php 
// PHP comment 
ips 
* Another PHP comment 
ay 


echo php_strip_whitespace ("test.php"); 
?> 


输出 : 


<?php 
echo php strip whitespace ("test.php"), ?> 


PHP show source() 函数 


= ~ i 
定义 和 用 法 
show source() 辑 数 对 文件 进行 语法 高 完 显 示 。 


AE highlight file() 的 别名 。 
语法 


show_source(filename,return) 


参数 描述 
filename We, BETSEY PHP 文件 的 路 径 。 
return 可 选 。 如 果 设 置 true， 则 本 画 数 返回 高 亮 处 理 的 代码 。 
说 明 


本 画 数 通过 使 用 PHP 语法 高 亮 程序 中 定义 的 颜色 ， 输 出 或 返回 包含 在 jename 中 的 代码 的 语 
法 高 亮 版 本 。 


许多 服务 器 被 配置 为 对 带 有 phps 后 级 的 文件 进行 自动 高 亮 处 理 。 例 如 ， 在 查看 
example.phps 时 ， 郊 显示 该 文件 被 语法 高 之 显示 的 源 代 码 。 要 上 启用 该 功能 ， 请 把 下 面 这 一 行 
添加 到 httod.conf : 


AddType application/x-httpd-php-source .phps 


3 [n] fi 


如 果 return 参数 被 设置 为 true, PBAAZHMARORKSRKRENKS, miei aed. B 
则 ， 若 成 功 ， 则 返回 true， 失 败 则 返回 false. 


提示 和 注释 


告 : 需要 注意 的 是 ， 在 使 用 show source() 函数 时 ， 请 不 要 因为 玖 忽而 泄露 诸如 密码 或 其 
类 型 的 敏感 信息 ， 否 则 会 出 现 潜在 的 安全 风险 。 


ck IR 


例子 


"test.php": 


«html» 
«body» 
«?php 


show source("test.php"); 


?> 
</body> 
</html> 


输出 : 


<html> 
<body> 
<?php 


show source("test.php"): 


?> 
</body> 
</html> 


在 浏览 器 中 查看 的 结 


<html> 
<body> 
<code> 


<span style-"color: 


<br /> 
&lt;body&gt; 
«br /» 


«span style-"color: 


:000000"-&lt;html&gt; 


40000BB"»&lt;?php 


«br />show source</span> 


<span style-"color: 
<span style-"color: 
<span style-"color: 
<span style-"color: 


&lt;/body&gt; 
«br /» 


&1t;/html&gt ; </span> 


</code> 
</body> 
</html> 


#007700">(</span> 
#DDO000">"test.php"</span> 
#007700">);<br /></span> 
#0000BB">?&gt;<br /></span> 


PHP sleep() 函数 


定义 和 用 法 


sleep() 函数 延迟 代码 执行 若干 秒 。 


语法 


sleep(seconds) 


必需 。 以 秒 计 的 暂停 时 间 。 


若 成 功 ， 返 回 0， 否 则 返回 false. 


错误 了 异常 


如 果 指 定 的 描述 seconds 是 负数 ， 该 画 数 将 生成 一 个 E. WARNING. 


例子 


<?php 


echo date('h:i:s') . 


//4 10 秒 
sleep(10); 


// 重 新 开始 


echo date("h:i:s"), 


?> 


输出 : 


12:00:08 
12:00:18 


"<br Jo 


PHP time nanosleep() 2X 
定义 和 用 法 

time nanosleep() 画 数 延 迟 代码 执行 若干 秒 和 纳 秒 。 
语法 


time nanosleep(seconds,nanoseconds) 


参数 描述 
seconds 必需 。 必 须 是 正 整 数 。 
nanoseconds 必需 。 必 须 是 小 于 10 亿 的 正 整数 。 


说 明 

延迟 程序 执行 指定 的 seconds 和 nanoseconds 数 。 
jx [Bl i 

如 果 成 功 则 返回 TRUE， 失败 则 返回 FALSE 


如 果 延 迟 被 一 个 信号 中 断 ， 将 返回 带 有 以 下 组 件 的 关联 数组 : 


e seconds - 延迟 中 剩余 的 秒 数 
e nanoseconds - 延迟 中 剩余 的 纳 秒 数 


提示 和 注释 


注释 : ARARE Windows 平台 下 实现 。 


例子 


<?php 
if (time_nanosleep(3,500000000) === true) 


{ 
echo "暂停 3 PK": 
j 


2» 


W3School PHP 参考 手册 


PHP time nanosleep() 函数 989 


PHP time sleep until() EAž% 


定义 和 用 法 
time sleep until() 本 数 延迟 代码 执行 直到 指定 的 时 间 。 
语法 


time sleep until(timestamp) 


参数 描述 
timestamp 必需 。 脚 本 唤醒 时 的 时 间 惟 。 


说 明 

使 脚本 暂停 执行 ， 直 到 指定 的 timestamp, 

jx [Bl i 

如 果 成 功 则 返回 TRUE, k k RIE] FALSE. 

错误 了 异常 

如 果 指 定 的 时 间 惟 位 于 过 去 ， 则 该 函数 将 生成 一 个 E_WARNING。 
提示 和 注释 

注释 : 所 有 信号 都 将 在 脚本 唤醒 后 递送 。 


注释 : ARARE Windows 平台 下 实现 


例子 


<?ph 

// 从 现在 起 10 秒 后 唤醒 

time sleep until(time( )+10), 
?> 


PHP uniqid() 函数 

定义 和 用 法 

unigid() 画 数 基 于 以 微 秒 计 的 当前 时 间 ， 生 成 一 个 唯一 的 ID, 
语法 


unigid(prefix,more entropy) 


nk 可 选 。 为 ID 规定 前 级。 如 果 两 个 脚本 恰好 在 相同 的 微 秒 生成 D, 该 参 
p 数 很 有 用 。 


more entropy ， 可 选 。 规 定位 于 返回 值 末 尾 的 更 多 的 炳 。 


说 明 


如 果 prefix 参数 为 空 ， 则 返回 的 字符 串 有 13 CFFE K. WR more entropy 参数 设置 
true, We 23 个 字符 串 长 。 


如 果 more entropy BRL true, WRECKER Z ABY 〈 使 用 组 合 线形 同 余数 
生成 程序 ) ， 这 样 可 以 结果 的 唯一 性 更 好 。 


3 [n] f& 
以 字符 串 的 形式 返回 唯一 标识 符 。 
提示 和 注释 


注释 : 由 于 基于 系统 时 间 ， 通 过 该 本 数 生成 的 ID 不 是 最 佳 的 。 如 需 生 成 绝对 唯一 的 ID， 请 使 
用 md5() 函数 (请 在 字符 串 函 数 参 考 中 柚 找 ) 。 


例子 


<?php 
echo uniqid(); 
?> 


W3School PHP 参考 手册 


输出 类 似 : 


4415297e3af8c 


PHP unigid() ES2X 992 


PHP unpack() HŽ% 
定义 和 用 法 

unpack() 函数 从 二 进 制 字符 串 对 数据 进行 解 包 。 
语法 


unpack(format, data) 


BR 描述 
format 必需 。 规 定 在 解 包 数据 时 所 使 用 的 格式 。 
data 可 选 。 规 定 被 解 包 的 二 进 制 数据 。 


format 参数 的 可 能 


e a- NUL-paddeg string 

e A- SPACE-paddeg string 

e h - Hex string, low nibble first 

e H - Hex string, high nibble first 

e c- signed char 

e C-unsigned char 

e s - signed short (always 16 bit, machine byte order) 

e S-unsigned short (always 16 bit, machine byte order) 

e n-unsigned short (always 16 bit, big endian byte order) 
e v-unsigned short (always 16 bit, little endian byte order) 
e i- signed integer (machine dependent size and byte order) 
e |- unsigned integer (machine dependent size and byte order) 
e |- signed long (always 32 bit, machine byte order) 

e L-unsigned long (always 32 bit, machine byte order) 

e N-unsigned long (always 32 bit, big endian byte order) 
e V - unsigned long (always 32 bit, little endian byte order) 
e f- float (machine dependent size and representation) 

e d - double (machine dependent size and representation) 
e x- NUL byte 

e X- Back up one byte 

e @ - NUL-fill to absolute position 


例子 
例子 1 


<?php 
$data = "PHP", 


print r(unpack("C*",$data)); 
?> 


例子 2 


<?php 
$data - "PHP"; 


print r(unpack("C*myint",$data)); 
?> 


输出 : 


Array 


( 
[myinti] -» 80 
[myint2] -» 72 
[myint3] -» 80 
) 


例子 3 


«?php 
$bin = pack("c2n2",0x1234, 0x5678, 65, 66); 


print r(unpack("c2chars/n2int",$bin)); 
?> 


输出 : 


Array 


[chars1] -» 52 
[chars2] -» 120 
[inti] -» 65 
[int2] -» 66 

) 


PHP usleep() 函数 
定义 和 用 法 

usleep() 画 数 延迟 代码 执行 若干 微 秒 。 
语法 


usleep(microseconds) 


参数 描述 
microseconds 必需 。 以 微 秒 计 的 暂停 时 间 。 


jx [B] (6 
无 返回 值 。 
E — Mrs 
提示 和 LEE 
注释 : TE PHP 5 2B, ARAD ALEF Windows 系统 上 。 


注释 : 一 微 秒 等 于 百 万 分 之 一 秒 。 


例子 


<?php 
echo date('h:i:s') . "<br />", 


// 延 迟 10 描述 
usleep(10000000), 





// 再 次 开始 
echo date("h:i:s"), 
?> 


输出 : 


09:23:14 
09:23:24 


PHP 5 时 区 


PHP 支持 的 时 区 


下 面 是 PHP 支持 的 时 区 的 完整 列表 ， 这 些 对 一 些 PHP ARRAREN. 


e 非洲 
。 美洲 
。 南极 洲 
e 北冰洋 
。 亚洲 
。 大 西洋 
。 大 洋 洲 
e. 欧洲 
e 印度 洋 
e 太平 洋 


非洲 





Africa/Abidjan Africa/Accra Africa/Addis Ababa Africa/Algiers 
Africa/Asmera Africa/Bamako Africa/Bangui Africa/Banjul 
Africa/Blantyre Africa/Brazzaville Africa/Bujumbura Africa/Cairo 
Africa/Ceuta Africa/Conakry Africa/Dakar Africa/Dar es Sale 
Africa/Douala Africa/El Aaiun Africa/Freetown Africa/Gaborone 
Africa/Johannesburg — Africa/Juba Africa/Kampala Africa/Khartoum 
Africa/Kinshasa Africa/Lagos Africa/Libreville Africa/Lome 
Africa/Lubumbashi Africa/Lusaka Africa/Malabo Africa/Maputo 
Africa/Mbabane Africa/Mogadishu Africa/Monrovia Africa/Nairobi 
Africa/Niamey Africa/Nouakchott | Africa/Ouagadougou Africa/Porto-Novo 
Africa/Timbuktu Africa/Tripoli Africa/Tunis Africa/Windhoek 


美洲 





America/Adak America/Anchorage Ame: 


America/Antigua 


America/Argentina/Catamarca 


America/Argentina/Jujuy 


America/Argentina/Rio Gallegos 


America/Argentina/San Luis 
America/Aruba 
America/Atka 
America/Barbados 
America/Blanc-Sablon 
America/Boise 
America/Campo Grande 
America/Catamarca 
America/Chicago 
America/Cordoba 
America/Cuiaba 
America/Dawson 
America/Detroit 
America/Eirunepe 
America/Fort Wayne 
America/Godthab 
America/Grenada 
America/Guayaquil 
America/Havana 
America/Indiana/Knox 
America/Indiana/Tell City 
America/Indiana/Winamac 
America/lqaluit 
America/Juneau 
America/Knox IN 
America/Lima 
America/Lower Princes 


America/Manaus 


America/Araguaina 


America/Argentina/ComodRivadavia 


America/Argentina/La Rioja 
America/Argentina/Salta 
America/Argentina/Tucuman 
America/Asuncion 
America/Bahia 
America/Belem 
America/Boa Vista 
America/Buenos Aires 
America/Cancun 
America/Cayenne 
America/Chihuahua 
America/Costa Rica 
America/Curacao 
America/Dawson Creek 
America/Dominica 
America/El Salvador 
America/Fortaleza 
America/Goose Bay 
America/Guadeloupe 
America/Guyana 
America/Hermosillo 
America/Indiana/Marengo 
America/Indiana/Vevay 
America/Indianapolis 
America/Jamaica 
America/Kentucky/Louisville 
America/Kralendijk 
America/Los Angeles 
America/Maceio 


America/Marigot 


America/Arge 
America/Arge 
America/Arge 
America/Arge 
America/Arge 
America/Atiko 
America/Bahii 
America/Beliz 
America/Bogc 
America/Cam 
America/Cara 
America/Cayr 
America/Cora 
America/Cres 
America/Danr 
America/Den\ 
America/Edm 
America/Ense 
America/Glac 
America/Gran 
America/Guat 
America/Halifi 
America/India 
America/India 
America/India 
America/Inuvi 
America/Jujuy 
America/Kent 
America/La F 
America/Louis 
America/Man: 


America/Marti 


America/Matamoros 
America/Menominee 
America/Mexico City 
America/Monterrey 
America/Montserrat 
America/Nipigon 
America/North Dakota/Beulah 
America/Ojinaga 
America/Paramaribo 
America/Port of Spain 
America/Puerto Rico 
America/Recife 
America/Rio Branco 
America/Santarem 
America/Sao Paulo 
America/Sitka 
America/St Kitts 
America/St Vincent 
America/Thule 
America/Toronto 
America/Virgin 


America/Yakutat 


南极 洲 


Antarctica/Casey 





Antarctica/McMurdo 


Antarctica/Vostok 


北冰洋 


Antarctica/Davis 


Antarctica/Palmer 


America/Mazatlan 
America/Merida 
America/Miquelon 
America/Montevideo 
America/Nassau 
America/Nome 
America/North Dakota/Center 
America/Panama 
America/Phoenix 
America/Porto Acre 
America/Rainy River 
America/Regina 
America/Rosario 
America/Santiago 
America/Scoresbysund 
America/St Barthelemy 
America/St Lucia 
America/Swift Current 
America/Thunder Bay 
America/Tortola 
America/Whitehorse 


America/Yellowknife 


Antarctica/DumontDUrville 


Antarctica/Rothera 


America/Ment 
America/Metle 
America/Mont 
America/Mont 
America/New. 
America/Noro 
America/Nortt 
America/Panc 
America/Port- 
America/Portc 
America/Rank 
America/Resc 
America/Santi 
America/Sant 
America/Shipi 
America/St JI 
America/St T 
America/Tegu 
America/Tijua 
America/Vanc 


America/Winn 


Antarctica/l 


Antarctica/S 





亚洲 


Asia/Aden 
Asia/Agtobe 
Asia/Baku 
Asia/Calcutta 
Asia/Dacca 
Asia/Dushanbe 
Asia/Hong Kong 
Asia/Jayapura 
Asia/Kashgar 
Asia/Krasnoyarsk 
Asia/Macau 
Asia/Nicosia 
Asia/Phnom Penh 
Asia/Rangoon 
Asia/Seoul 
Asia/Tbilisi 
Asia/Tokyo 
Asia/Ust-Nera 


Asia/Yerevan 


大 西洋 


Atlantic/Azores 
Atlantic/Faroe 


Atlantic/St_Helena 


大 洋 沙 





Arctic/Longyearbyen 


Asia/Almaty 
Asia/Ashgabat 
Asia/Bangkok 
Asia/Choibalsan 
Asia/Damascus 
Asia/Gaza 
Asia/Hovd 
Asia/Jerusalem 
Asia/Kathmandu 
Asia/Kuala Lumpur 
Asia/Magadan 
Asia/Novokuznetsk 
Asia/Pontianak 
Asia/Riyadh 
Asia/Shanghai 
Asia/Tehran 
Asia/Ujung Pandang 


Asia/Vientiane 


Atlantic/Bermuda 
Atlantic/Jan Mayen 
Atlantic/Stanley 


Asia/Amman 
Asia/Ashkhabad 
Asia/Beirut 
Asia/Chongqing 
Asia/Dhaka 
Asia/Harbin 
Asia/Irkutsk 
Asia/Kabul 
Asia/Katmandu 
Asia/Kuching 
Asia/Makassar 
Asia/Novosibirsk 
Asia/Pyongyang 
Asia/Saigon 
Asia/Singapore 
Asia/Tel_ Aviv 


Asia/Ulaanbaatar 


Asia/Vladivostok 


Atlantic/Canary 
Atlantic/Madeira 


Asia/Anadyr 
Asia/Baghdad 
Asia/Bishkek 
Asia/Chungking 
Asia/Dili 
Asia/Hebron 
Asia/Istanbul 
Asia/Kamchatka 
Asia/Khandyga 
Asia/Kuwait 
Asia/Manila 
Asia/Omsk 
Asia/Qatar 
Asia/Sakhalin 
Asia/Taipei 
Asia/Thimbu 
Asia/Ulan Bator 
Asia/Yakutsk 


Atlantic/Cape Verde 


Atlantic/Reykjavik 


Tm mI mI mI mI mI» mI > 


Australia/ACT Australia/Adelaide Australia/Brisbane Australia/Broke 


Australia/Currie Australia/Darwin Australia/Eucla Australia/Hobart 
Australia/Lindeman — Australia/Lord Howe Australia/Melbourne Australia/North 
Australia/Perth Australia/Queensland — Australia/South Australia/Sydney 
Australia/Victoria Australia West Australia/Yancowinna 


欧洲 





Europe/Amsterdam Europe/Andorra Europe/Athens Europe/Belfast 
Europe/Berlin Europe/Bratislava Europe/Brussels Europe/Bucharest 
Europe/Busingen Europe/Chisinau Europe/Copenhagen — Europe/Dublin 
Europe/Guernsey Europe/Helsinki Europe/lsle of Man Europe/Istanbul 
Europe/Kaliningrad Europe/Kiev Europe/Lisbon Europe/Ljubljana 
Europe/Luxembourg Europe/Madrid Europe/Malta Europe/Mariehamn 
Europe/Monaco Europe/Moscow Europe/Nicosia Europe/Oslo 
Europe/Podgorica Europe/Prague Europe/Riga Europe/Rome 
Europe/San Marino Europe/Sarajevo Europe/Simferopol Europe/Skopje 
Europe/Stockholm Europe/Tallinn Europe/Tirane Europe/Tiraspol 
Europe/Vaduz Europe/Vatican Europe/Vienna Europe/Vilnius 
Europe/Warsaw Europe/Zagreb Europe/Zaporozhye Europe/Zurich 


印度 洋 


Indian/Antananarivo — Indian/Chagos — Indian/Christmas Indian/Cocos Ind 
Indian/Kerguelen Indian/Mahe Indian/Maldives Indian/Mauritius — Indi 


Indian/Reunion 


太平 洋 


Pacific/Apia 
Pacific/Efate 
Pacific/Galapagos 
Pacific/Johnston 
Pacific/Marguesas 
Pacific/Noumea 
Pacific/Ponape 
Pacific/Tahiti 
Pacific/Wallis 


Pacific/Auckland 
Pacific/Enderbury 
Pacific/Gambier 
Pacific/Kiritimati 
Pacific/Midway 
Pacific/Pago_Pago 


Pacific/Port_Moresby 


Pacific/Tarawa 


Pacific/Yap 


Pacific/Chatham 
Pacific/Fakaofo 
Pacific/Guadalcanal 
Pacific/Kosrae 
Pacific/Nauru 
Pacific/Palau 
Pacific/Rarotonga 


Pacific/Tongatapu 


Pacific/Chuuk 
Pacific/Fiji 
Pacific/Guam 
Pacific/Kwajalein 
Pacific/Niue 
Pacific/Pitcairn 
Pacific/Saipan 


Pacific/Truk 


免责 声明 


W3School 提 供 的 内 容 仅 用 于 培训 。 我 们 不 保证 内 容 的 正确 性 。 通 过 使 用 本 站 内 容 随 之 而 来 的 
风险 与 本 站 无 关 。W3School 简 体 中 文 版 的 所 有 内 容 仅 供 测试 ， 对 任何 法 律 问题 及 风险 不 承担 
任何 责任 。 


